

















Spring Boot 作 为 Java 编 程 语言 的 一 个 全 新 开发 框架 ， 在 国内 外 才刚 刚 兴起 ， 还 未 得 到 普及 使 用 。 相 比 于 以 往 的 一 些 开发 框架 ，Spring Boot 不 但 使 用 更 加 简单 ， 而 且 功 能 更 加 丰富 ， 性 能 更 加 稳定 而 健 


































































































壮 。 使 用 Spring Boot 开 发 框架 ， 不 仅 能 提高 开发 速度 ， 增 强生 产 效 率 ， 从 某 种 意义 上 ， 可 以 说 是 解放 了 程序 员 的 劳动 ， 而 且 一 种 新 技术 的 使 用 ， 更 能 增强 系统 的 稳定 性 和 扩展 系统 的 性 能 指标 。 本 书 就 是 本 
着 提高 开发 效率 ， 增 强 系统 性 能 ， 促 进 新 技术 的 普及 使 用 这 一 目的 而 写 的 。 




























































































Spring Boot 是 在 Spring 框架 基础 上 创建 的 一 个 全 新 框架 ， 其 设计 目的 是 简化 Spring 应 用 的 搭建 和 开发 过 程 ， 它 不 但 具有 Spring 的 所 有 优秀 特性 ， 而 且 具 有 如 下 显著 的 特点 : 


. 为 Spring 开发 提供 更 加 简单 的 使 用 和 快速 开发 的 技巧。 
































“ 具有 开 箱 即 用 的 默认 配置 功能 ， 能 根据 项 目 依赖 自动 配置 。 


“ 具有 功能 更 加 强大 的 服务 体系 ， 包 括 典 入 式 服务 、 安 全 、 性 能 指标 、 健 康 检查 等 。 


“ 绝对 没有 代码 生成 ， 可 以 不 再 需要 XML 配置 ， 即 可 让 应 用 更 加 轻巧 和 灵活 。 








Spring Boot 对 于 一 些 第 三 方 技术 的 使 有 






































虽然 Spring Boot 具 有 这 么 多 优秀 的 特性 ， 但 它 使 




















， 提 供 了 非常 完美 的 整合 ， 使 你 在 简单 的 使 有 中， 不 知 不 觉 运用 了 非常 高 级 和 先进 的 技术 。 






























































起 来 并 不 复杂 ， 而 且 非 常 简单 ， 所 以 不 管 是 java 程序 开发 初学 者 ， 还 是 经 验 丰富 的 开发 人 员 ， 使 用 Spring Boot 都 是 一 个 理想 的 选择 。 








Spring Boot 发 展 迅 速 ， 自 从 2014 年 4 月 发 布 了 1.0.0 版 本 ， 至 今 已 经 发 布 了 1.4.0 正 式 版 。 现 在 ，Spring Boot 正 在 不 同 的 角落 中 悄然 兴起 ， 估 计 用 不 了 多 久 ， 它 将 成 为 Java 开 发 的 又 一 个 热潮 ， 为 众多 

















Java 开 发 者 追捧 。 

















本 书 将 以 一 些 非常 切合 生产 实际 的 应 














关于 本 书 








实例 ， 带 你 一 起 使 








Spring Boot 框 架 ， 开 始 一 段 愉快 的 快速 开发 和 探索 之 旅 。 
































本 书 以 丰富 的 实例 ， 介 绍 了 如 何 使 用 Spring Boot 开 发 框架 进行 基础 应 用 和 分 布 式 应 用 等 方面 的 开发 ， 并 且 介 绍 了 如 何 使 用 Spring Boot 开 发 的 应 用 搭建 一 个 高 性 能 的 服务 平台 ， 同 时 还 对 Spring Boot 
的 一 些 核心 功能 的 源 代码 进行 了 分 析 ， 从 而 加 深 对 Spring Boot 的 理解 。 书 中 对 从 最 基本 的 入 门 知识 ， 到 数据 库 的 使 用 ， 以 及 界面 设计 、 安 全 设计 等 领域 都 做 了 详细 的 介绍 和 探讨 ， 并 在 分 布 式 应 用 系统 领 

















域 ， 以 平台 级 应 用 系统 的 实例 ， 介 绍 了 如 何 创 建 和 使 





















































































































































SSO 管 理 系统 、 分 布 式 文件 系统 ， 如 何 使 用 Spring Cloud 进 行 云 应 用 方面 的 开发 ， 以 及 如 何 使 用 Docker 发 布 和 构建 高 可 用 的 分 布 式 系统 服务 平台 。 同 















































时 ， 对 Spring Boot 的 程序 加 载 、 自 动 配置 、 数 据 管理 ， 和 Spring Cloud 的 配置 管理 、 发 现 服务 和 负载 均衡 服务 等 核心 功能 的 源 代码 做 了 深入 剖析 ， 这 样 在 认识 其 实现 原理 的 基础 上 ， 能 更 好 地 使 用 其 相应 














的 功能 。 
































书 分 为 三 个 部 分 : 第 一 部 分 (第 1~5 章 ) 介绍 基础 应 用 方面 的 开发 ， 包 含 简单 入 门 知识 、 数 据 库 使 用 、 界 面 设计 和 安全 设计 等 内 容 ; 第 二 部 分 (第 6~9 章 ) 介绍 了 Spring Boot 在 分 布 式 系统 开发 和 云 














应 用 开发 等 方面 的 应 用 以 及 使 用 微服 务 构建 高 可 用 的 服务 平台 



































衡 服务 等 实现 原理 进行 了 深入 的 剖析 。 


本 书 章节 编排 


第 1 章 为 Spring Boot 入 门 ， 介 绍 开发 环境 
























































; 第 三 部 分 (第 10~12 章 ) 对 Spring Boot 的 程序 加 载 、 自 动 配置 和 数据 管理 的 实现 原理 ， 以 及 Spring Cloud 的 配置 管理 、 发 现 服务 和 负载 均 















































的 搭建 和 开发 工具 的 选择 及 安装 配置 ， 并 使 用 一 个 非常 简单 的 实例 ， 说 明 如 何 轻易 地 使 用 Spring Boot 开 发 框架 。 












































第 2 章 使 用 Spring Boot 框 架 演示 了 以 不 同 于 以 往 的 方式 ， 





























以 及 如 何 轻易 地 使 用 数据 库 ， 并 实际 演示 使 用 MySQL、MongoDB、Redis 和 Neo4j 等 数据 库 。 























第 3 章 使 用 Thymeleaf 模 板结 合 一 些 流行 的 Javascript 播 件 ， 介 绍 了 使 用 Spring Boot 进 行 界面 设计 的 方法 和 技巧 。 















































第 4 章 对 使 用 Spring Boot 提 高 传统 关系 型 数据 库 的 性 能 























面 做 了 一 些 探讨 和 尝试 ， 并 扩展 了 使 用 JPA 资 源 库 的 功能 。 























第 5 章 介 绍 了 如 何 使 用 Spring Boot 结 合 Spring Security 进 行 安全 设计 ， 包 括 登录 认证 和 角色 管理 、 权 限 管理 等 内 容 。 





























第 6 章 介绍 如 何 使 用 Spring Security 结 合 OAuth2 进 行 SSO (Single Sign On) 的 设计 ， 并 演示 如 何在 分 布 式 应 用 系统 中 使 用 认证 授权 和 安全 管理 的 功能 。 

















第 7 章 介绍 如 何 使 用 Spring Boot 框 架 结合 











第 8 章 介绍 云 应 用 开发 ， 包 括 配置 管理 、 















































第 9 章 介 绍 如 何 使 用 Docker 引 警 和 docker-compose 工 


发 现 服务 和 监控 



























































分 布 式 文件 系统 FastDFS， 并 使 用 定制 方式 和 富 文本 编辑 器 的 方式 演示 了 使 用 图 片上 传 和 建立 本 地 图 片 库 的 方法 。 
































民 务 的 使 用 ， 以 及 如 何 使 用 动态 路 由 和 断路 器 的 功能 ， 创 建 高 可 用 的 微服 务 应 用 。 






























































来 发 布 应 用 和 管理 服务 ， 以 及 如 何 构建 一 个 高 性 能 的 服务 平台 和 怎样 使 用 Docker 实 施 负载 均衡 。 

















第 10 章 分 析 了 Spring Boot 的 应 用 程序 加 载 和 自动 配置 原理 ， 以 及 如 何以 改造 加 载 配置 的 方式 来 提高 应 用 的 性 能 。 




















第 11 章 分 析 了 Spring Boot 使 用 数据 库 的 实现 原理 ， 并 演示 怎样 利用 一 些 技术 手段 提高 和 扩展 访问 数据 库 的 功能 。 









































第 12 章 简要 分 析 了 微服 务 中 配置 管理 、 发 现 服务 和 负载 均衡 服务 的 实现 原理 和 部 分 核心 源 代码 ， 并 使 用 一 个 实例 说 明 配置 管理 中 分 布 式 消息 的 实现 机 制 和 原理 。 




















附录 A~ 附 录 D 介 绍 了 Neo4j、MongoDB、Redis、RabbitMQ 等 服务 器 的 安装 、 配 置 和 基本 使 用 方法 。 


读者 对 象 





























本 书 适 于 所 有 Java 编 程 语言 开发 人 员 ， 所 有 对 Spring Boot 感 兴趣 并 希望 使 用 Spring Boot 开 发 框架 进行 开发 的 人 员 ， 已 经 使 用 过 Spring Boot 框 架 但 希望 更 好 地 使 用 Spring Boot 的 开发 人 员 ， 以 及 系统 
设计 师 、 架 构 师 等 设计 人 员 。 同 时 ， 本 书 对 运 维 人 员 和 DBA 等 也 具有 一 定 的 参考 价值 。 


实例 代码 


















































本 书 的 实例 代码 可 以 通过 https://github.com/chenfromsz?tab=repositories 查 看 和 下 载 ， 推 荐 根据 每 章 的 提示 使 用 Intellij IDEA 通 过 GitHub 检 出 各 章 的 实例 工程 ， 这 样 可 以 保留 原来 工程 的 配置 ， 并 











且 能 够 直接 使 用 。 














反馈 与 勘误 











读者 如 有 反馈 意见 可 以 通过 https://github.com/chenfromsz/correct/issues 发 起 新 话题 与 作者 进行 交互 ， 在 这 也 可 能 会 发 布 一 些 勘 误 信 息 ， 以 便 纠 正 不 可 避免 的 错误 。 
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首先 ， 非 常 感谢 华 阳 信 通 公司 ， 虽 然 本 书 的 编写 过 程 大 都 在 业余 时 间 完成 ， 但 是 公司 强大 的 平台 给 本 书 的 实例 提供 了 更 加 方便 的 分 享 、 验 证 和 测试 条 件 。 同 时 在 本 书 的 编写 过 程 中 ， 也 得 到 了 我 们 的 开 
发 团队 和 众多 朋友 的 大 力 支持 和 帮助 ， 在 此 表示 囊 心 的 感谢 ! 最 后 感谢 华章 公司 的 杨 福 川 和 李 艺 ， 他 们 在 本 书 编辑 的 过 程 中 ， 提 出 了 一 些 宝贵 而 有 益 的 建议 ， 并 为 本 书 的 出 版 做 了 许多 工作 。 




















由 于 时 间 仓 促 和 水 平 有 限 ， 书 中 难免 出 现 一 些 红 漏 或 不 正确 的 地 方 ， 敬 请 大 家 批评 指正 ! 


第 一 部 分 “基础 应 用 开发 


“第 l 章 ”Spring Boot 入 门 
: 第 2 章 ”在 Spring Boot 中 使 用 数据 库 
“ 第 3 章 Spring Boot 界 面 设计 


“ 第 4 章 ”提高 数据 库 访 问 性 能 





志 


“第 5 章 ”Spring Boot 安 全 设计 

这 一 部 分 从 搭建 开发 环境 ， 简 单 入 门 ， 到 使 用 数据 库 、 界 面 设计 、 安 全 管理 等 一 系列 内 容 ， 介 绍 了 使 用 Spring Boot 框 架 进 行 基础 应 用 开发 的 方法 。 
第 1 章 介 绍 了 开发 环境 的 搭建 和 开发 工具 的 选择 和 安装 ， 并 以 一 个 非常 简单 的 实例 ， 演 示 了 如 何 使 用 Spring Boot 框 架 创建 工程 和 发 布 应 用 。 
第 2 章 介 绍 了 如 何 用 Spring Boot 特 有 的 方式 ， 使 用 当前 流行 的 数据 库 : MySQL、Redis、MongoDB、Neo4j 等 。 

第 3 章 介 绍 如何 使 用 Thymeleaf 模 板结 合 一 些 流行 的 JavaScript 插 件 ， 设 计 应 用 界面 。 

第 4 章 使 用 Druid 数 据 库 连 接 池 和 Redis 做 缓存 来 尝试 提升 关系 型 数据 库 的 访问 性 能 ， 并 扩展 了 JPA 的 资源 库 功 能 。 


第 5 章 在 Spring Boot 中 使 用 Spring Security 为 应 用 系统 进行 安全 设计 ， 实 现 了 登录 认证 和 权限 管理 方面 的 功能 。 


第 1 章 Spring Boot 入 门 


















































在 使 用 Spring Boot 框 架 进行 各 种 开发 体验 之 前 ， 要 先 配 置 好 开发 环境 。 首 先 安装 JDK， 然 后 选择 一 个 开发 工具 ， 如 Eclipse IDE 和 Intelljy IDEA (以 下 简称 IDEA) 都 是 不 错 的 选择 。 对 于 开发 工具 的 选 
择 ， 本 书 极力 推荐 使 用 DEA， 因 为 它 为 Spring Boot 提 供 了 许多 更 好 和 更 贴切 的 支持 ， 本 书 的 实例 都 是 使 用 IDEA 创 建 的 。 同 时 ， 还 需要 安装 Apache Maven 和 Git 客 户 端 。 所 有 这 些 都 准备 好 之 后 ， 我 们 就 
能 开始 使 用 Spring Boot 了 。 



























































1.1 配置 开发 环境 





























下 面 的 开发 环境 配置 主要 以 使 用 Windows 操 作 系统 为 例 ， 如 果 你 使 用 的 是 其 他 操作 系统 ， 请 对 照 其 相关 配置 进行 操作 。 























1.1.1 安装 JDK 


JDK (Java SE Development Kit) 需要 1.8 及 以 上 版 本 ， 可 以 从 Java 的 官网 http://www.oracle.com/technetwork/java/javase/downloads/index.html 下 载 安装 包 。 如 果 访 问 官网 速度 慢 的 话 ， 也 可 
以 通过 百度 搜索 JDK， 然 后 在 百度 软件 中 心 下 载 符合 你 的 Windows 版 本 和 配置 的 JDK1.8 安 装 包 。 














安装 完成 后 ， 配 置 环境 变量 JAVA_HOME， 例 如 ， 使 用 路 径 D: \Program Files\Java\jdk1.8.0_25 (如 果 你 安装 的 是 这 个 目录 的 话 ) 。JAVA_HOME 配 置 好 之 后 ， 将 9JAVA_HOME%Nbin 加 入 系统 的 环 
境 变量 path 中 。 完 成 后 ， 打 开 一 个 命令 行 窗口 ， 输 入 命令 java-version， 如 果 能 正确 输出 版 本 号 则 说 明 安装 成 功 了 。 输 出 版 本 的 信息 如 下 : 




















C:\Users\Alan>java-version 

java version "1.8.0 25" 

Java(TM) SE Runtime Environment (build 1.8.0 25-b18) 

Java HotSpot (TM) 64-Bit Server WM (build 25.25-b02, mixed mode) 





1.1.2 ”安装 Interllij IDEA 








IDEA 需 要 14.0 以 上 的 版 本 ， 可 以 从 其 官网 http://www.jetbrains.com/ 下 载 免费 版 ， 本 书 的 实例 是 使 用 IDEA14.1.15 版 本 开发 的 。IDEA 已 经 包含 Maven 揪 件 ， 版 本 是 3.0.5， 这 已 经 能 够 适用 我 们 开发 的 
要 求 。 安 装 完成 后 ， 打 开 IDEA， 将 显示 如 图 1-1 所 示 的 欢迎 界面 ， 在 这 里 可 以 看 到 IDEA 的 版 本 号 。 





























| Welcome to Intelly ID 


spring-boot-hello 


spring-boot-db i 


poe IntelliJ IDEA 


spring-boot-security 
E\ideworkspace\spring-boot-security , 
Create New Project 
spring-boot-dbup 
Import Project 
四 Open 
spring-boot-ul 


Check out from Version Contro|l v 


Contigure v Get Help v 














1-1 Intedlj IDEA 欢 迎 界面 









































为 了 能 够 在 命令 行 窗口 中 使 用 Maven 来 管理 工程 ， 可 以 安装 一 个 Maven 管 理工 具 。 通 过 Maven 的 官网 http:// iche.org/down 下 载 3.0.5 以 上 的 版 本 ， 下 载 完 后 解压 缩 即 可 ， 例 如 ， 解 
压 到 D: 盘 上 是 不 错 的 做 法 ， 然 后 将 Maven 的 安装 路 径 (如 D'Napache-maven-3.2.3\bin) 记 )i 和 Windows 的 环 培训 看 bath 中 安装 完成 后 ， 在 命令 行 窗口 中 执行 指令 : mvn-v， 将 输出 如 下 的 版 本 信息 以 
及 系统 的 一 些 环境 信息 。 

















C:\Users\Alan>mvn-v 

Apache Maven 3.2.3 (33f8c3el027c3ddde99d3cdebad2656a31le8fdf4; 2014-08-12T04:58:1 

0+08:00) 

Maven home: D:\apache-maven-3.2.3\bin\http://www.hzcourse.com/resource/readBook?path=/openresources/teach ebook/uncompressed/15925/0EBPS/Text/.. 
Java version: 1.8.0 25, vendor: Oracle Corporation 

Java home: D:\Program Files\Java\jdk1.8.0 25\jre 

Default locale: zh CN, platform encoding: GBK 


OS name: "windows 7", version: "6.1", arch: "amd64", family: "dos" 




















建议 更 改 IDEA 中 Maven 资 源 库 的 存放 路 径 ， 可 以 先 在 Maven 安 装 路 径 中 创建 一 个 资源 库 目录 ， 如 repository。 然 后 打开 Maven 的 配置 文件 ， 即 安装 目录 conf 中 的 settings.xml， 找 到 下 列 代 码 ， 将 路 径 
更 改 为 repository 所 在 的 位 置 ， 并 保存 在 注释 符 下 面 。 


























例如 找到 下 列 代码 行 





<localRepository>/path/to/local/repo</localRepository> 





复制 出 来 改 为 如 下 所 示 : 





<localRepository>D:\apache-maven-3.2.3\repository</localRepository> 














改 好 后 可 以 拷贝 一 份 settings.xml 放 置 在 gfuser.homej/.m2/ 下 面 ， 这 样 做 可 以 不 用 修改 IDEA 的 Maven 这 个 配置 。 在 图 1-2 所 示 的 Maven 配 置 界面 中 ，User Settings File 保 持 了 默认 位 置 ，Local 
Repository 使 用 了 上 面 设置 的 路 径 D:\apache-maven-3.2.3\repository， 而 Maven 程 序 还 是 使 用 了 IDEA 自 带 的 版 本 。 






























































由 于 本 书 的 实例 工程 都 存放 在 GitHub (https://git pm/) 中 ， 所 以 还 需要 在 GitHub 中 免费 注册 一 个 用 户 (可 以 通过 E-mail 直接 注册 免费 用 户 ) ， 以 方便 在 IDEA 中 从 GitHub 检 出 本 书 的 实例 工 
程 。 当 然 ， 如 果 不 想 注册 ， 通 过 普通 下 载 的 方法 也 能 取得 实例 工程 的 源 代 码 。GitHub 是 世界 级 的 代码 库 服 务 器 ， 如 果 你 愿意 ， 也 可 以 将 它 作为 你 的 代码 库 服务 器 ， 在 这 里 还 可 以 搜索 到 全 世界 的 开发 者 分 享 
出 来 的 源 程序 。 图 1-3 是 打开 GitHub 的 首页 。 


















































Build, Execution, Deployment > Build Tools > Maven 互 
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图 1-2 ”Maven 设 置 


© Personal Opensource Business Explore 
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Millions of developers use GitHub to build personal 
projects, support their businesses, and work together 
Eee i Eel oes) esiss 
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Introducing unlimited All of our paid plans on GitHub com now include unlimited private repositories. Sign up to 
private repositories get started or read more about this change on our blog. 


图 1-3” ”GitHub 首页 


1DEA 还 需要 Git 客 户 端 程序 的 支持 。 可 以 从 其 官网 https://git-scm.com/download/ 下 载 Git 客 户 端 安装 包 。 安 装 非常 简单 ， 按 提示 单 击 “下 一 步 ”并 选择 好 安装 路 径 即 可 。 安 装 完成 后 ， 在 Windows 的 
资源 管理 器 中 ， 单 击 鼠 标 右键 弹出 的 菜单 中 将 会 多 出 如 下 几 个 选择 菜单 : 


Git Init Here 
Git Gui 
Git Bash 


其 中 Git Bash 是 一 个 带 有 UNIX 指 令 的 命令 行 窗口 ， 在 这 里 可 以 执行 一 些 Git 指 令 ， 用 来 提交 或 者 检 出 项 目 。 









































在 IDEA 中 对 Git 的 设置 ， 只 要 指定 git.exe 执 行文 件 的 位 置 即 可 。 图 1-4 是 IDEA 中 Git 客 户 端的 配置 ， 其 中 Git 的 路 径 被 设置 在 D: \Program Files\Git\bin\git.exe 中 ， 这 主要 由 安装 Git 客 户 端的 位 置 而 
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1-4 ”Git 设置 




















连接 成 功 的 提示 。 
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如 果 已 经 在 GitHub 中 注册 了 用 户 ， 即 可 以 打开 如 图 1-5 所 示 的 GitHub 配 置 ， 输 入 用 户 名 和 密码 ， 然 后 单 击 Test 按 钮 ， 如 果 设 置 正确 的 话 将 会 返 





























Version Control ; GitHub ® 
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图 1-5 GitHub 配置 


Os: <% 上面 IDEA 的 一 些 设置 界面 都 可 以 单 击 工具 栏 上 的 Settings 按 钮 打开 ， 打 开 File 菜 单 ， 选 择 Settings 同 样 也 可 以 打开 。 























现在 ， 可 以 尝试 使 用 IDEA 来 创建 一 个 项 目 工程 。 如 果 是 第 一 次 打开 IDEA， 可 以 选择 Create New Project 创 建 一 个 新 工程 。 如 果 已 经 打开 了 IDEA， 在 File 菜 单 中 选择 New Project， 也 能 打开 New 
Project 对 话 框 ， 如 图 1-6 所 示 。 使 用 IDEA 创 建 一 个 Spring Boot 项 目 有 很 多 方法 ， 这 里 只 介绍 使 用 Maven 和 Spring Initializr 这 两 种 方法 来 创建 一 个 新 项 目 。 一 般 使 用 Maven 来 新 建 一 个 项 目 ， 因 为 这 样 更 容 
易 按 我 们 的 要 求 配置 一 个 项 目 。 
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使 用 Maven 新 建 一 个 项 目 主要 有 以 下 三 个 步骤 。 
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1-6 ”新 建 一 个 Maven 项 目 














在 图 1-6 中 的 Project SDK 下 拉 列 表 框 中 选择 前 面 安装 的 Java 1.8， 如 果 下 拉 列 表 框 中 不 存在 Java 1.8， 可 以 单 击 New 按 钮 ， 找 到 安装 Java 的 位 置 ， 选 择 它 。 然 后 在 左面 侧 边栏 的 项 目 类 型 中 ， 选 择 
Maven 项 目 ， 即 可 使 用 Maven 作 为 项 目的 管理 工具 。 至 于 Maven 中 的 archetype， 因 为 我 们 并 不 打算 使 用 其 中 任何 一 种 类 型 ， 所 以 不 用 勾 选 ， 然 后 单 击 Next 进 入 下 一 步 。 
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1-7 所 示 ， 单 击 Next 进 入 下 一 步 。 

















在 Project location 编 辑 框 中 选择 和 更 改 存 放 路 径 ， 在 Project name 输 入 框 中 输入 与 Artifactld 相 同 的 项 目 名 称 : “spring-boot-hello”， 如 图 1-8 所 示 。 




















单 击 Finish， 完 成 项 目 创建 ， 这 样 将 在 当前 窗口 中 打开 一 个 新 项 目 ， 如 图 1-9 所 示 。 其 中 ， 在 工程 根 目录 中 生成 了 一 个 pom.xml， 即 Maven 的 项 目 对 象 模型 (Project Object Model) ， 并 生成 了 源 代 
码 目录 java、 资 源 目录 resources 和 测试 目录 test 等 ， 即 生成 了 一 个 项 目的 一 些 初始 配置 和 目录 结构 。 
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1-7 输入 GroupId 和 ArtifactId 
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Project name: spring-boot-hello 


Project location; ENdeaworkspring-boot-hello 


ettings 


Module name: spring-boot-hello 


Content root: E:\ideawork\spring-boot-hello 


Module file location: E:\deawork\spring-boot-hello 


Project format: ‘dea (directory based) 


Previous Finish Cancel 


图 1-8 指定 项 目 名 称 和 存放 路 径 


g-boo DEA 
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图 1-9 ”初始 创建 的 项 目 














下 一 节 将 使 用 这 个 项 目 工程 来 创建 第 一 个 使 用 Spring Boot 开 发 框架 的 应 用 实例 。 









































新 建 一 个 Spring Boot 项 目 ， 也 可 以 使 有 





可 















































可 以 使 用 默认 选项 ， 注 意 Type 为 Maven Project，Java Version 为 1.8，Packaging 为 Jar， 如 图 1-11 所 示 。 单 击 Next 进 入 下 一 步 。 























Spring Initializr 的 方式 ， 这 种 方式 很 简单 ， 如 图 1-10 所 示 。 注 意 Initializr Service URL 为 h 
版 本 和 组 件 列表 。 使 用 这 种 方式 新 建 项 目 大 体 上 也 需要 三 个 步骤 。 


ring.io， 这 将 会 连接 网 络 ， 以 查询 Spring Boot 的 当前 


选择 Spring Boot 版 本 和 Spring Boot 组 件 ， 例 如 ， 在 Spring Boot Version 中 选择 1.3.5， 并 义 选 Web 项 目 组 件 ， 如 图 1-12 所 示 ， 然 后 单 击 Next 进 入 下 一 步 。 
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1-10 新 建 一 个 SpringBoot 项 目 





Cancel 


加 | New Project 


ET demo 

Type: Maven Project (Generate a Maven 
Packaging: 

java Version: 

Language': java 

Group; com.example 


Artifact: demo 


Version:; 0.0.1-SNAPSHOT 


Description: Demo project for Spring Boot 


Package: com.example 














1-11 
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选择 项 目 类 型 
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1-12 选择 版 本 和 组 件 

















选择 存放 路 径 后 输入 项 目 名 称 ， 如 图 1-13 所 示 ， 这 里 使 用 demof 作 为 项 目的 名 称 。 

















Project name: dern ol 


Project location: ' EN\ideworkspace\demo 


» More Settings 


Prewvlous Finish Cancel 


图 1-13 输入 项 目 名 称 


单 击 Finish， 将 创建 一 个 初始 化 项 目 ， 如 图 1-14 所 示 。 这 个 项 目 不 但 有 完整 的 目录 结构 ， 还 有 一 个 完整 的 Maven 配 置 ， 并 且 生 成 了 一 个 默认 的 主 程序 ， 几 乎 所 有 的 准备 工作 都 已 经 就 绪 ， 并 且 可 以 立即 
运行 起 来 (虽然 没有 提供 任何 可 用 的 服务 ) 。 这 也 是 Spring Boot 引 以 为 傲 的 地 方 ， 即 创建 一 个 应 用 可 以 不 用 编写 任何 代码 ， 只 管 运行 即 可 。 
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图 1-14 使 用 Spring Initializr 创 建 的 初始 项 目 


1.3 ”使 用 Spring Boot 





























任何 应 用 的 开发 都 需要 对 项 目的 创建 、 运 行 和 发 布 等 进行 管理 ， 使 用 Spring Boot 框 架 进行 开发 ， 可 以 选择 使 用 Maven 或 Gradle 





























格 项 目 管理 工具 。 在 这 里 我 们 使 用 的 是 Maven。 














1.3.1 Maven 依 赖 管理 



































使 用 Maven， 通 过 导入 Spring Boot 的 starter 模 块 ， 可 以 将 许多 程序 依赖 包 自动 导入 工程 中 。 使 用 Maven 的 parent POM ， 还 可 以 更 容易 地 管理 依赖 的 版 本 和 使 用 默认 的 配置 ， 工 程 中 的 模块 也 可 以 很 
方便 地 继承 它 。 例 如 ， 使 用 1.2.1 节 创建 的 工程 ， 修 改 pom.xml 文 件 ， 使 用 如 代码 清单 1-1 所 示 的 简单 Maven 配 置 ， 基 本 上 就 能 为 一 个 使 用 Spring Boot 开 发 框架 的 Web 项 目 开发 提供 所 需 的 相关 依赖 。 


















































代码 清单 1-1 Spring Boot Web 基 本 依赖 配置 















































<2xml version="1.0" encoding="UTF-8"?> 
<project xmlns="http://maven.apache.org/POM/4.0.0" 
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" 
xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 
http://maven.apache.org/xsd/maven-4.0.0.xsd"> 
<modelVersion>4.0.0</modelVersion> 
<groupId>springboot .example</groupId> 
<artifactId>spring-boot-hello</artifactId> 
<version>1.0-SNAPSHOT</version> 
<parent> 
<groupId>org.springframework.boot</groupId> 
<artifactId>spring-boot-starter-parent</artifactId> 
<version>1.3.2.RELEASE</version> 
</parent> 
<dependencies> 
<dependency> 
<groupId>org.springframework.boot</groupId> 
<artifactId>spring-boot-starter-web</artifactId> 
</dependency> 
</dependencies> 
</project> 

















这 里 只 使 用 了 一 个 依赖 配置 spring-boot-starter-web 和 一 个 parent 配 置 spring-boot-starter-parent， 在 工程 的 外 部 库 (External Libraries) 列表 中 ， 它 自动 引入 的 依赖 包 如 代码 清单 1-2 所 示 。 








代码 清单 1-2 ”Maven 加 载 的 依赖 列表 








<orderEntry 
<orderEntry 









ibrary" name="Maven: org.springframework.boot:spring-boot-starter-web:1.3.2.RELEASE" level="project" /> 
ibrary" name="Maven: org.springframework.boot:spring-boot-starter:1.3.2.RELEASE" level="project" /> 


<orderEntry ibrary" org.springframework.boot:spring-boot:1.3.2.RELEASE" level="project" /> 

<orderEntry ibrary" org.springframework.boot:spring-boot-autoconfigure:1.3.2.RELEASE" level="project" /> 
<orderEntry ibrary" org.springframework.boot:spring-boot-starter-logging:1.3.2.RELEASE" level="project" /> 
<orderEntry ibrary" : ch.qos.logback:logback-classic:1.1.3" level="project" /> 

<orderEntry ibrary" name="Maven: ch.qos.logback:logback-core:1.1.3" level="project" /> 

<orderEntry ibrary" name="Maven: org.slf4j:slf4j-api:1.7.13" level="project" /> 

<orderEntry ibrary" name="Maven: org.slf4j:jcl-over-slf4j:1.7.13" level="project" /> 

<orderEntry ibrary" name="Maven: org.slf4j:jul-to-slf4j:1.7.13" level="project" /> 

<orderEntry ibrary" name="Maven: org.slf4j:1l0g4j-over-slf4j:1.7.13" level="project" /> 

<orderEntry ibrary" name="Maven: org.springframework:spring-core:4.2.4.RELEASE" level="project" /> 





‘project" /> 


/> 


<orderEntry ibrary" RUNTIME" name="Maven: org.yaml:snakeyaml:1.16" level="project" /> 

<orderEntry ibrary" : Org.springframework.boot:spring-boot-starter-tomcat:1.3.2.RELEASE" level=" 

<orderEntry ibrary" org.apache.tomcat .embed:tomcat-embed-core:8.0.30" level="project" /> 

<orderEntry ibrary" org.apache.tomcat .embed:tomcat-embed-el:8.0.30" level="project" /> 

<orderEntry ibrary" org.apache.tomcat .embed:tomcat-embed-logging-juli:8.0.30" level="project" 

<orderEntry ibrary" name="Maven: org.apache.tomcat.embed:tomcat-embed-websocket:8.0.30" level="project" /> 

<orderEntry ibrary" name="Maven: org.springframework.boot:spring-boot-starter-validation:1.3.2.RELEASE" level="project" /> 

















<orderEntry ibrary" : org.hibernate:hibernate-validator:5.2.2.Final" level="project" /> 
<orderEntry ibrary" javax.validation:validation-api:1.1.0.Final" level="project" /> 
<orderEntry ibrary" org.jboss.1logging:jboss-logging:3.3.0.Final" level="project" /> 
<orderEntry ibrary" : Com.fasterxml:classmate:1.1.0" level="project" /> 

<orderEntry ibrary" name="Maven: com.fasterxml .jackson.core:jackson-databind:2.6.5" level="project" /> 
<orderEntry ibrary" name="Maven: com.fasterxml .jackson.core:jackson-annotations:2.6.5" level="project" /> 
<orderEntry ibrary" com. fasterxml .jackson.core:jackson-core:2.6.5" level="project" /> 
<orderEntry ibrary" org.springframework:spring-web:4.2.4.RELEASE" level="project" /> 
<orderEntry ibrary" org.springframework:spring-aop:4.2.4.RELEASE" level="project" /> 
<orderEntry ibrary" aopalliance:aopalliance:1.0" level="project" /> 

<orderEntry ibrary" org.springframework:spring-beans:4.2.4.RELEASE" level="project" /> 
<orderEntry ibrary" name="Maven: org.springframework:spring-context:4.2.4.RELEASE" level="project" /> 
<orderEntry ibrary" name="Maven: org.springframework:spring-webmvc:4.2.4.RELEASE" level="project" /> 





<orderEntry library" name="Maven: org.springframework:spring-expression:4.2.4.RELEASE" level="project" /> 





在 工程 的 外 部 库 列 表 中 ，Spring Boot 已 经 导入 了 整个 springframework 依 赖 ， 以 及 autoconfigure、logging、slf4j、jackson、 
括 你 已 经 考虑 到 的 和 没有 考虑 到 的 ) ， 它 真是 一 个 聪明 的 助手 。 


1.3.2 一 个 简单 的 实例 











tomcat 插 件 等 ， 所 有 这 些 都 是 一 个 Web 项 目 可 能 需要 用 到 的 东西 ( 包 


























Spring Boot 的 官方 文档 中 提供 了 一 个 最 简单 的 Web 实 例 程序 ， 这 个 实例 只 使 用 了 几 行 代 码 ， 如 代码 清单 1-3 所 示 。 虽 然 简单 ， 但 实际 上 这 已 经 可 以 算 作 是 一 个 完整 的 Web 项 目 了 。 














代码 清单 1-3 ”Spring Boot 简 单 实例 





Package springboot .example; 
import org.springframework.boot.SpringApplication; 
import org.springframework.boot.autoconfigure.SpringBootApplication; 
import org.springframework.web.bind.annotation.RequestMapping; 
import org.springframework.web.bind.annotation.RestController; 
@SpringBootApplication 
Q@RestController 
Public class Application { 

@RequestMapping ("/") 

String home () { 

return "hello"; 


public static void main (String[] args) { 
SpringApplication.run (Application.class, args); 





























这 个 简单 实例 ， 首 先是 一 个 Spring Boot 应 用 的 程序 入 口 ， 或 者 叫 作 主 程序 ， 其 中 使 用 了 一 个 注解 @SpringBootApplication 来 标注 它 是 一 个 Spring Boot 应 用 ，main 方 法 使 它 成 为 一 个 主 程序 ， 将 在 应 
























































启动 时 首先 被 执行 。 其 次 ， 注 解 @RestController 同 时 标注 这 个 程序 还 是 一 个 控制 器 ， 如 果 在 浏览 器 中 访问 应 用 的 根 目录 ， 它 将 调 























home 方 法 ， 并 输出 字符 串 : hello。 








1.4 ”运行 与 发 布 
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本 章 实例 工程 的 完整 代码 可 以 使 用 IDEA 直 接 从 GitHub 的 https://github.com/chen-fromsz/spring-boot-hello.git 中 检 出 ， 如 




















1-15 所 示 ， 单 击 Clone 按 钮 将 整个 项 目 复制 到 本 地 。 


Clone Reposito 


Git Repository URL: 
Parent Directory: 


Directory Name: 








jithub.com/chenfromsz/sprin 


E:\deworkspace 


spring-boot-hello 


g-boot-hello.g 训 





1.4.1 在 IDEA 环 境 中 运行 


图 1-15 


检 出 实例 工程 


在 IDEA 中 打开 Run 菜 单 ， 选 择 Edit Configuration 打 开 Run/Debug Configurations 对 话 框 ， 在 配置 界面 的 左边 侧 边 栏 中 选择 增加 一 个 Application 或 Spring Boot 配 置 项 目 ， 然 后 在 工作 目录 中 选择 工 
程 所 在 的 根 目录 ， 主 程序 选择 代码 清单 1-3 创 建 的 类 : springboot.example.Application， 并 将 配置 保存 为 hello， 如 图 1-16 所 示 。 


然后 选择 Run 习 


bug 运 行 hello 配 置 项 目 。 如 果 启 动 成 功 ， 将 在 控制 台中 输出 类 似 如 下 


/openresour 


penresou: 


{http://www.hzcour: 
.http 


bp 


com/resource/readBook?path=/openresourc: 


urse. e/r k? k /unc .http 





+ 9 


vv ow@Spring Boot 
-lls 


pb SFDefaults 





1.4.2 ”将 应 用 打包 发 布 


上 面 操作 演示 了 在 IDEA 环 境 中 如 何 运行 一 个 应 用 。 如 果 我 们 想 把 应 用 发 布 出 去 ， 需 要 怎么 做 呢 ? 可 以 将 人 


Name: | hello 


Configuration Logs 


Main class 


Program arguments: 
Working dire 


Environment variables: 


Use classpath of med， 


Override parameters 


Enabled 


图 1-16 


Share 


springboot.example.Application 


D:\deawork\s 


Spring Boot 应 用 配置 


清单 1-1 中 的 Maven 配 置 增加 一 个 发 布 插件 来 实现 。 丸 


插件 : spring-boot-maven-plugin， 并 增加 了 一 行 打包 的 配置 : <packaging>jar</packaging> ， 这 行 配置 指定 将 应 用 工程 打包 成 jar 文 件 。 


A ngle instance only 





清单 1-4 所 示 ， 增 加 了 一 个 打包 





es/teach ek 


代码 清单 1-4 包含 打包 插件 的 Maven 配 置 





<?xml version="1.0" encoding="UTF-8"?> 
<project xmlns="http://maven.apache.org/POM/4.0.0" 
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" 
xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 
http://maven.apache.org/xsd/maven-4.0.0.xsd"> 
<modelVersion>4.0.0</modelVersion> 
<groupId>springboot .example</groupId> 
<artifactId>spring-boot-hello</artifactId> 
<version>1.0-SNAPSHOT</version> 
<packaging>jar</packaging> 
<parent> 
<groupId>org.springframework.boot</groupId> 
<artifactId>spring-boot-starter-parent</artifactId> 
<version>1.3.2.RELEASE</version> 
</parent> 
<dependencies> 
<dependency> 
<groupId>org.springframework.boot</groupId> 
<artifactId>spring-boot-starter-web</artifactId> 
</dependency> 
</dependencies> 
<build> 
<plugins> 
<plugin> 
<groupId>org.springframework.boot</groupId> 
<artifactId>spring-boot-maven-plugin</artifactId> 





<executions> 
<execution> 
<goals> 
<goal>repackage</goal> 
</goals> 
</execution> 
</executions> 
</plugin> 
</plugins> 
</build> 
</project> 


这 样 就 可 以 在 IDEA 中 增加 一 个 打包 的 配置 ， 打 开 Run/Debug Configurations 对 话 框 ， 选 择 增 加 配置 一 个 Maven 打 包 项 目 ， 在 工作 目录 中 选择 工程 所 在 根 目 录 ， 在 命令 行 中 输入 package， 并 将 配置 保 
存 为 mvn， 如 图 1-17 所 示 。 























运行 mvn 打 包 项 目 ， 就 可 以 将 实例 工程 打包 ， 打 包 的 文件 将 输出 在 工程 的 target 目 录 中 。 











如 果 已 经 按照 1.1.3 节 的 说 明 安装 了 Maven， 也 可 以 直接 使 用 Maven 的 命令 打包 。 打 开 一 个 命令 行 窗口 ， 将 路 径 切 换 到 工程 根 目录 中 ， 直 接 在 命令 行 输入 mvn package， 同 样 也 能 将 项 目 打 包 成 jar 文 
件 。 执 行 结果 如 下 : 








加 | Run/Debug Configuratio 


@ Spring Boot 
pb SF Defaults 





图 1-17 Maven 打 包 配 置 





http://www.hzcourse.com/resource/readBook?path=/openresources/teach ebook/uncompressed/15925/0EBPS/Text/. .http://www.hzcourse.com/resource/readBook?path=/openresources/teach ek 
[INFO] --- maven-jar-plugin:2.5:jar (default-jar) @ spring-boot-hello --— 

[INFO] Building jar: E:\ideworkspace\spring-boot-hello\target\spring-boot-hello- 

1.0-SNAPSHOT.jar 

[INFO] 
[INFO] - 
oot-hello 
[INFO] ----— 
[INFO] BUILD SUCCESS 

5 (RE EE 
[INFO] Total time: 21.450 s 

[INFO] Finished at: 2016-05-08T16:54:44+08:00 

[ 

[ 





spring-boot-maven-plugin:1.3.2.RELEASE:repackage (default) @ spring-b 








INFO] Final Memory: 23M/118M 
INFO] 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 
































打包 成 功 后 ， 在 工程 的 target 目 录 中 将 会 生成 jar 文 件 spring-boot-hello-1.0-SNAPSHOT,jar。 在 命令 行 窗口 中 切换 到 target 目 录 中 ， 运 行 如 下 指令 ， 就 能 启动 应 用 。 





























java -jar spring-boot-hello-1.0-SNAPSHOT.jar 








如 果 希 望 按照 传统 的 做 法 ， 将 工程 发 布 成 war 文 件 ， 应 当 将 代码 清单 1-4 的 Maven 配 置 <packaging>jar</packaging> 改 成 <packaging>war</packaging>， 这 样 就 可 以 打包 成 war 文 件 。 打 包 完 成 
后 将 war 文 件 放置 在 Tomcat 的 webapp 路 径 中 ， 启 动 Tomcat 就 能 自动 运行 程序 。 























这 里 需要 注意 的 是 ， 如 果 自 主 使 用 omcat 运 行 应 用 ， 在 安装 JDK 时 必须 配置 JAVA_HOME 环 境 变量 ， 同 时 JDK 要 求 1.8 以 上 的 版 本 ，Tomcat 必 须 是 8.0 以 上 的 版 本 。 


















































我 更 加 喜欢 打包 成 jar， 然 后 使 用 Spring Boot 的 嵌入 插件 Tomcat 运 行 应 用 。 本 书 所 有 实例 都 可 以 打包 成 jar 直 接 运行 。 即 使 对 于 一 个 包含 很 多 页 面 、 图 片 、 脚 本 等 资源 的 复杂 应 用 系统 ， 这 种 方法 也 是 可 
行 的 ， 并 且 打 包 成 jar， 更 方便 项 目 发 布 在 Docker 上 运行 ， 这 些 将 在 后 面 的 章节 中 详细 介绍 。 






































1.5 关于 Spring Boot 配 置 














关于 Spring Boot 配 置 ， 可 以 在 工程 的 resources 文 件 夹 中 创建 一 个 application.properties 或 application.yml 文 件 ， 这 个 文件 会 被 发 布 在 classpath 中 ， 并 且 被 Spring Boot 自 动 读 取 。 这 里 推荐 使 有 
application.yml 文 件 ， 因 为 它 提供 了 结构 化 及 其 谋 套 的 格式 ， 例 如 ， 可 以 按 如 下 所 示 配 置 上 面 的 工程 ， 将 默认 端口 改 为 80， 并 且 将 Tomcat 的 字符 集 定义 为 UTF-8。 

































































server: 
port: 80 
tomcat: 

uri-encoding: UTF-8 

















如 果 要 使 用 application.properties 文 件 ， 上 面 的 配置 就 要 改 成 如 下 所 示 的 样子 ， 其 结果 完全 相同 。 








server.port = 80 
SerVer .tomcat .uri-enconding = UTF-8 





























使 用 这 个 配置 文件 可 以 直接 使 用 Spring Boot 预 定义 的 一 些 配 置 参数 ， 关 于 其 他 配置 参数 的 详细 说 明和 描述 可 以 查看 官方 的 文档 说 明 : https://docs.spring.io/spring- 
boot/docs/current/reference/html/common-application-properties.html。 在 后 面 的 开发 中 将 在 用 得 到 的 地 方 选择 使 用 这 些 预 定义 的 配置 参数 。 即 使 没有 预定 义 的 配置 参数 可 用 ， 也 能 很 容易 地 按照 应 
的 需要 自 定义 一 些 配置 参数 ， 这 将 在 后 续 的 章节 中 详细 介绍 。 





























































































































1.6 小 结 
































本 章 主要 介绍 了 Spring Boot 开 发 环境 的 搭建 ， 以 及 一 些 开发 工具 的 安装 配置 ， 内 容 难免 有 点 枯燥 。 然 后 创建 并 运行 一 个 非常 简单 的 实例 工程 ， 让 性 急 的 读者 一 睹 Spring Boot 的 芳 容 。 


























本 章 实例 工程 只 是 使 用 Spring Boot 框 架 进行 开发 的 非常 简单 的 入 门 指 引 。 因 为 Spring Boot 开 发 框架 是 一 个 非常 轻 量 级 的 开发 框架 ， 所 以 也 有 人 把 它 叫 作 微 框架 ， 从 入 门 指引 中 可 以 看 出 ,使 用 Spring 
Boot 框 架 开发 应 用 不 但 入 门 容易 ， 而 且 其 蕴藏 的 无 比 强大 的 功能 ， 使 开发 过 程 也 变 得 更 加 容易 。 







































































下 面 ， 让 我 们 使 用 Spring Boot 框 架 进行 一 些 更 加 有 趣 的 开发 吧 。 这 一 章 只 是 小 试 牛刀 而 已 ， 在 后 续 章节 中 将 使 用 Spring Boot 框 架 来 开始 一 些 真正 的 开发 。 























第 2 章 在 Spring Boot 中 使 用 数据 库 






































使 用 数据 库 是 开发 基本 应 用 的 基础 。 借 助 于 开发 框架 ， 我 们 已 经 不 用 编写 原始 的 访问 数据 库 的 代码 ， 也 不 用 调用 JDBC (Java Data Base Connectivity) 或 者 连接 池 等 诸如 此 类 的 被 称 作 底层 的 代码 ， 
我 们 将 在 高 级 的 层次 上 访问 数据 库 。 而 Spring Boot 更 是 突破 了 以 前 所 有 开发 框架 访问 数据 库 的 方法 ， 在 前 所 未 有 的 更 加 高 级 的 层次 上 访问 数据 库 。 因 为 Spring Boot 包 含 一 个 功能 强大 的 资源 库 ， 为 使 
Spring Boot 的 开发 者 提供 了 更 加 简便 的 接口 进行 访问 。 































































































本 章 将 介绍 怎样 使 用 传统 的 关系 型 数据 库 ， 以 及 近期 一 段 时 间 异 军 突起 的 NoSQL (Not Only SQL) 数据 库 。 

















本 章 的 实例 工程 使 用 了 分 模块 的 方式 构建 ， 各 模块 的 定义 如 表 2-1 所 示 。 








表 2-1 实例 工程 模块 定义 


项 目 正 程 功 能 
MySQL 模块 使 用 MySQL 
Redis 模块 使 用 Redis 
MongoDB 模块 使 用 MongoDB 
Neo4j 模块 使 用 Neo4j 


2.1 使 用 MySQL 














对 于 传统 关系 型 数据 库 来 说 ，Spring Boot 使 用 JPA (Java Persistence AP1) 资源 库 来 实现 对 数据 库 的 操作 ， 使 用 MySQL 也 是 如 此 。 简 单 地 说 ，JPA 就 是 为 POJO (Plain Ordinary Java Object) 提供 
持久 化 的 标准 规范 ， 即 将 Java 的 普通 对 象 通过 对 象 关 系 映射 (Object-Relational Mapping，ORM) 持久 化 到 数据 库 中 。 











2.1.1 ”MySQL 依赖 配置 

















JPA 和 MySQL， 首 先 在 工程 中 引入 它们 的 Maven 依 赖 ， 如 代码 清单 2-1 所 示 。 





为 了 使 





代码 清单 2-1 JPA 和 Mysql 依 赖 配置 


其 中 ， 指 定 了 在 运行 时 调用 MySQL 的 依赖 。 





<dependencies> 

<dependency> 
<groupId>org. springframework.boot</groupId> 
<artifactId>spring-boot-starter-data-jpa</artifactId> 

</dependency> 

<dependency> 
<groupId>mysql</groupId> 
<artifactId>mysql-connector-java</artifactId> 
<scope>runtime</scope> 





</dependency> 
</dependencies> 
2.1.2 ”实体 建 模 























来 与 数据 库 的 表 建 立 映射 关系 ， 接 着 演示 如 何 使 





首先 创建 一 些 普通 对 象 ， 


JPA 对 数据 库 进 行 增删 查 改 等 存 取 操 作 。 
























































假如 现在 有 三 个 实体 : 部 门 、 


隶属 


户 和 角色 ， 并 且 它 们 具有 一 定 的 关系 ， 即 一 个 用 户 只 能 隶属 于 一 个 部 门 ， 一 个 


可 以 拥有 多 个 角色 。 它 们 的 关系 模型 如 图 2-1 所 示 。 




















用 户 








图 2-1 


日 期 称 


MySQL 实体 -关系 模型 示例 














Spring Boot 的 实体 建 模 与 使 用 Spring 框架 时 的 定义 方法 一 样 ， 同 样 比 较 方便 的 是 使 











了 注解 的 方式 来 实现 。 





























部 门 实体 的 建 模 如 代码 清单 2-2 所 示 ， 其 中 注解 @Table 指 定 关联 的 数据 库 的 表 名 ， 注 解 @1d 定 义 一 条 记录 的 唯一 标识 ， 并 结合 注解 @GeneratedValue 将 其 设置 为 自动 生成 。 部 门 实体 只 有 两 个 字段 : 


























id 和 name。 程 序 中 省 略 了 Getter 和 Setter 方 法 的 定义 ， 这 些 方法 可 以 使 





代码 清单 2-2 部 门 实体 建 模 





IDEA 的 自动 生成 工具 很 方便 地 生成 。 





Q@Entity 
@Table (name = "deparment") 
public class Deparment { 
@Id 
Q@GeneratedValue (strategy = GenerationType.IDENTITY) 
private Long id; 
Private String name; 
public Deparment () { 


























实体 包含 三 个 字段 : id、name 和 createdate， 上 


























户 实体 建 模 如 代码 清单 2-3 所 示 。 其 中 注解 @ManyToOne 定 义 它 与 部 门 的 多 对 一 关系 ， 并 且 在 数据 库 表 中 











字段 did 来 表示 部 门 的 ID， 注 解 












































@ManyToMany 定 义 与 角色 实体 的 多 对 多 关系 ， 并 且 用 中 间 表 user_role 来 存储 它们 各 自 的 ID， 以 表示 它们 的 对 应 关系 。 日 期 类 型 的 数据 必须 使 用 注解 @DateTimeFormat 来 进行 格式 化 ， 以 保证 它 在 存 取 
时 能 提供 正确 的 格式 ， 避 免 保 存 失败 。 注 解 @JsonBackReference 用 来 防止 关系 对 象 的 递归 访问 。 
代码 清单 2-3 ”用 户 实体 建 模 
@Entity 
QTable (name = "user") 
public class User implements java.io.Serializable{ 
@I 
Q@GeneratedValue (strategy = GenerationType.IDENTITY) 
private Long id; 
Private String name; 
Q@DateTimeFormat (pattern = "yyyy-MM-dd HH:mm:ss") 
private Date createdate; 
@ManyToOne 
@JoinColum (name = "did") 
Q@JsonBackReference 
private Department deparment; 
@ManyToMany (cascade = {}, fetch = FetchType .EAGER) 
@JoinTable (name = "user role", 
joinColumns = {GJoinColum (name = "user id")}, 
inverseJoinColumns = {@JoinColumn (name = "roles id")}) 


private List<Role> roles; 
public User() { 











角色 实体 建 模 比较 简单 ， 只 要 按 设计 的 要 求 ， 定 义 id 和 name 字 段 即 可 ， 当 然 同 样 必须 保证 id 的 唯一 性 并 将 其 设 定 为 自动 生成 。 角 色 实 体 的 建 模 如 代码 清单 2-4 所 示 。 


代码 清单 2-4 ”角色 实体 建 模 





Q@Entity 
QTable (name = "role") 
Public class Role implements java.io.Serializable{ 
@Id 
@GeneratedValue (strategy = GenerationType.IDENTITY) 
private Long id; 
Private String name; 
public Role() { 





2.1.3 ”实体 持久 化 























通过 上 面 三 个 实体 的 定义 ， 实 现 了 使 用 Java 的 普通 对 象 (POJO) 与 数据 库 表 建立 映射 关系 (ORM) ， 接 下 来 使 F 














JPA 来 实现 持久 化 。 























使 



































户 实体 使 用 JPA 进 行 持久 化 的 例子 如 代码 清单 2-5 所 示 。 它 是 一 个 接口 ， 并 继承 于 JPA 资 源 库 jpaRepository 接 口 ， 
为 其 他 程序 提供 存 取 数据 库 的 功能 。 


















































同样 继承 于 JpaRepository 接 口 ， 只 要 注意 使 











使 用 相同 的 方法 ， 可 以 定义 部 门 实体 和 角色 实体 的 资源 库 接口 。 接 














代码 清单 2-5 ”用 户 实体 持久 化 














注解 @Repository 将 这 个 接口 也 定义 为 一 个 资源 库 ， 使 它 能 被 其 他 程序 引 


























的 参数 是 各 自 的 实体 对 象 即 可 。 





@Repository 
public interface UserRepository extends JpaRepository<User, Long> { 
} 





这 样 就 实现 存 取 数据 库 的 功能 了 。 现 在 可 以 对 数据 库 进 行 增删 查 改 、 进 行 分 页 查询 和 指定 排序 的 字段 等 操作 。 





或 许 你 还 有 疑问 ， 我 们 定义 的 实体 资源 库 接口 并 没有 声明 一 个 方法 ， 也 没有 对 接口 有 任何 实现 的 代码 ， 甚 至 连 一 条 SQL 查询 语句 都 没有 写 ， 这 怎么 可 能 ? 


























是 的 ， 使 用 JPA 就 是 可 以 这 么 简单 。 我 们 来 看 看 JpaRe-pository 的 继承 关系 ， 你 也 许 会 明白 一 些 。 如 图 2-2 所 示 ，JpaRepository 继 承 于 























能 ，PagingAndSortingRepository 继 承 于 Crud-Repository， 它 提供 了 简单 的 增删 查 改 功能 。 





FPagingAndSortingRepository， 它 提供 了 分 页 和 排序 功 





Repository 


CrudRepository 


PagingAndSortingReposito 





JpaRepository 


图 2-2 JpaRepository 接 口 继承 关系 








为 定义 的 接口 继承 于 JjpaRepository， 所 以 它 传递 性 地 继承 上 面 所 有 这 些 接 口 ， 并 拥有 这 些 接口 的 所 有 方法 ， 这 样 就 不 难 理解 为 何 它 包含 那么 多 功能 了 。 这 些 接口 提供 的 一 些 方法 如 下 : 





























<S extends T> S save(S var1) 

T findone (ID var1) 

long count () ， 

void delete (ID var1) 

void delete (T varl); 

void deleteAll (); 

Page<T> findAll] (Pageable varl); 
List<T> findAll (); 

List<T> findAll (Sort varl); 

List<T> findAll (Iterable<ID> varl); 
void deleteAllInBatch(); 

T getone (ID varl); 
http://www.hzcourse.com/resource/readBook?path=/openresources/teach ebook/uncompressed/15925/0EBPS/Text/. .http://www.hzcourse.com/resource/readBook?path=/openresources/teach ek 

















JPA 还 提供 了 一 些 自 定义 声明 方法 的 规则 ， 例 如 ， 在 接口 中 使 用 关键 字 findBy、readBy、getBy 作 为 方法 名 的 前 级 ,拼接 实体 类 中 的 属性 字段 ( 首 个 字母 大 写 ) ， 并 可 选择 拼接 一 些 SQL 查 询 关 键 字 来 组 
合成 一 个 查询 方法 。 例 如 ， 对 于 用 户 实体 ， 下 列 查询 关键 字 可 以 这 样 使 


















































` And， 例 如 findByIdAndName (Longid, String name) ; 

Or， 例如 findByIdOrName (Longid，Stringname) ; 

Between， 例如 findByCreatedateBetween (Date startt，Date end) ; 
' LessThan， 例 如 findByCreatedateLessThan (Date start) ; 
:GreaterThan ， 例 如 findByCreatedateGreaterThan (Date start) ; 


IsNull， 例 如 findByNamelIsNull () ; 


“ IsSNotNull， 例 如 findByNameIsNotNull () ; 


' NotNull， 与 INotNull 等 价 ; 


“ Like， 例 如 findByNameLike (String name) 


3; 


3 


“ NotLike ， 例 如 findByNameNotLike (String name) ; 


“ OrderBy， 例 如 findByNameOrderByIdAsc (String name) ; 


“ Not, 例如 findByNameNot (String name) 


x 


“ In， 例如 findByNameIn (Collection<Stting>nameList) ; 


" NotIn， 例 











又 如 下 列 对 





如 findByNameNotIn (Collection<String>nameList) 。 


户 实体 类 自 定义 的 方法 声明 ， 它 们 都 是 符合 JPA 规 则 的 ， 这 些 方 法 也 不 














实现 ，JPA 将 会 代理 实现 这 些 方法 。 





User findByNameLike (String name); 
User readByName (String name); 


List<User> getByCreatedateLessThan (Date star); 





2.1.4” MySQL 测试 








现在 ， 为 了 验证 上 面 设 计 的 正确 性 ， 我 们 








一 个 实例 来 测试 一 下 。 




















首先 ,增加 一 个 使 














JPA 的 配置 类 ， 如 代码 清和 














库 的 位 置 ; @EntityScan 指 定 了 定义 实体 的 位 
的 配置 类 把 一 些 配置 参数 都 包含 在 类 定义 中 了 。 











代码 清单 2-6 ”JPA 配 置 类 


， 它 将 导入 我 们 定义 的 实体 。 注 意 ， 在 测试 时 使 


m2-6 所 示 。 其 中 @EnableTransac-tionManagement 启 用 了 JPA 的 导 






































































































































有 务 管理 ，@ EnableJpaRepositories 启 用 了 JPA 资 源 库 并 指定 了 上 面 定义 的 接口 资源 
的 JPA 配 置 类 可 能 与 这 个 配置 略 有 不 同 ， 这 个 配置 的 一 些 配置 参数 是 从 配置 文件 中 读 取 的 ， 而 测试 时 使 














QOrder (Ordered.HIGHEST PRECEDENCE) 
@Configuration 


@EnableTransactionManagement (proxyTargetClass = true) 


@EnableJpaRepositories (basePackages = 

Q@EntityScan (basePackages = 

public class JpaConfiguration { 
@Bean 


"dbdemo.**.repository") 
"dbdemo.**.entity") 


PersistenceExceptionTranslationPostProcessor persistenceExceptionTranslationPostProcessor (){ 
return new PersistenceExceptionTranslationPostProcessor (); 


} 








其 次 ,在 MySQL 数 据 库 








肛 务 器 中 创建 一 个 数据 库 test， 然 后 配 
建 一 个 具有 完全 权限 访问 数据 库 test 的 用 户 ， 可 以 在 连接 MySQL 服 务 器 的 查询 窗口 




















一 个 可 以 访问 这 个 数据 库 的 

















户 及 其 密码 。 数 据 库 的 表 结 构 可 以 不 用 创建 ， 
中 执行 下 面 指令 ， 这 个 指令 假设 你 将 在 本 地 中 访问 数据 库 。 











在 程序 运行 时 将 会 按照 实体 的 定义 自动 创建 。 如 果 还 没有 创 





grant all privileges on test.* to 'root'@'localhost' identified by '12345678'; 


然后 ， 在 Spring Boot 的 配置 文件 application.yml 中 使 


代码 清单 2-7 ”数据 源 和 JPA 配 置 




















如 代码 清单 2-7 所 示 的 配置 ， 



































来 设置 数据 源 和 JPA 的 工作 模式 。 





spring: 
datasource: 


url: jdbc:mysql:// localhost:3306/test?characterEncoding=utf8 


root 
12345678 


username: 
password: 
jpa: 
database: 
show-sql: 


MYSQL 
true 


#Hibernate ddl auto (validate|create|create-drop|update) 


hibernate: 
ddl-auto: update 


naming-strategy: org.hibernate.cfg.ImprovedNamingStrategy 


Properties: 
hibernate: 


dialect: org.hibernate.dialect .MySQLS5Dialect 

















配置 中 将 ddl-atuo 设 置 为 update， 就 是 使 有 




















Hibernate 来 自动 更 新 表 结 构 的 ， 即 如 果 数据 表 不 存在 则 创建 ， 或 者 


最 后 ， 编 写 一 个 测试 程序 ， 如 代码 清单 2-8 所 示 。 测 试 程序 首先 初始 化 数据 库 ， 创 建 一 个 部 门 ， 命 名 为 “开发 部 ”， 





定 为 上 面 创建 的 部 门 ， 并 将 现 有 的 所 有 角色 都 分 配给 这 个 


代码 清单 2-8 MySQL 测试 程序 

















户 。 然 后 使 











分 页 的 方式 查询 所 有 











户 的 列表 ， 并 从 查 到 的 





果 修改 了 表 结 构 ， 在 程序 启动 时 则 执行 表 结 构 的 同步 更 新 。 


创建 一 个 角色 ， 命 名 为 admin， 创 建 一 个 























户 列表 中 ， 打 印 出 




















， 命 名 为 user， 同 时 将 它 的 所 


户 的 名 称 、 部 门 的 名 称 和 第 一 个 角色 的 名 称 等 信息 。 





属 部 门 设 





@RunWith (SpringJUnit4ClassRunner.class) 
{JpaConfiguration.class}) 


@ContextConfiguration (classes = 
public class MysqlTest { 
private static Logger logger = 
@Autowired 
UserRepository userRepository; 
QAutowired 


DepartmentRepository departmentRepository; 


@Autowired 

RoleRepository roleRepository; 

@Before 

Public void initData(){ 
userRepository.deleteAll (); 
roleRepository.deleteAll (); 


departmentRepository.deleteAll (); 
Department department = new Department (); 


department .setName (" 开 发 部 ") 7 


departmentRepository.save (department) 7 
RAssert .notNull (department .getId()) 7 


Role role = new Role(); 
role.setName ("admin"); 
roleRepository.save (role); 
Assert .notNull (role.getId()); 


LoggerFactory.getLogger (MysqlTest .class); 


User user = new User(); 
user. setName ("user"); 
user.setCreatedate (new Date () ) ; 
user.setDeparment (department); 
List<Role> roles = roleRepository.findAll (); 
Assert .notNull (roles); 
user.setRoles (roles); 
userRepository.save (user); 
Assert .notNull (user.getId()); 
} 
QTest 
public void findqPage (){ 
Pageable pageable = new PageRequest (0, 10, new Sort (Sort .Direction.ASC， 


"id")); 
Page<User> page = userRepository.findAll (pageable); 
Assert .notNull (page); 
for (User user : page.getContent ()) { 
logger .info ("====User==== user name:{}, department name:{}, role 
name:{}", 
user.getName (), user.getDeparment () .getName (), user.getRoles(). 


get (0) .getName () ) 7 
} 
} 


























好 了 ,现在 可 以 使 用 JUnit 来 运行 这 个 测试 程序 了 ， 在 IDEA 的 Run/Debug Configuration 配 置 中 增加 一 个 JUint 配 置 项 ， 模 块 选择 mysql， 工 作 目 录 选 择 模 块 所 在 的 根 目 录 ， 程 序 选 择 
dbdemo.mysql.test.MysqlTest， 并 将 配置 项 目 名 称 保存 为 mysqltest， 如 图 2-3 所 示 。 

































































Debug 方 式 运行 测试 配置 项 目 mysqltest， 可 以 在 控制 台中 看 到 执行 的 过 程 和 结果 。 如 果 状 态 栏 中 显示 为 绿色 ， 并 且 提 示 “All Tests passed” ， 则 表示 测试 全 部 通过 。 在 控制 台中 也 可 以 查 到 下 列 打 
印信 息 : 











dbdemo .mysql .test .MysqlTest - ===—user==== user name:user, department name :开发 部 ，role name:admin 








这 时 如 果 在 MySQL 服 务 器 中 查看 数据 库 test， 不 但 可 以 看 到 表 结 构 都 已 经 创建 了 ， 还 可 以 看 到 上 面 测试 生成 的 一 些 数据 。 











这 是 不 是 很 激动 人 心 ? 在 Spring Boot 使 用 数据 库 ， 就 是 可 以 如 此 简单 和 有 趣 。 到 目前 为 止 ， 我 们 不 仅 没有 写 过 一 条 查询 语句 ， 也 没有 实现 一 个 访问 数据 库 的 方法 ， 但 是 已 经 能 对 数据 库 执行 所 有 的 操 
作 ， 包 括 一 般 的 增删 查 改 和 分 页 查询 。 








Bl Run/Debug Configurations 


+ mY Name: mysqltest Share Single instance only 


v [JUnit 


Configuration Code Coverage logs 


[下 neo4j 
»mongotest Test lind: Class Fork mode: none 


»redistest 
Glass dbdemo.mys 
"mysqltest 


pb os@Spring Boot 
pb FDefaults 
YM opti 


Working directory: E:\deworkspace\spring-boot-db\mysql 


Environment variables 


Use cl Dath of mod... [C3 mysq 


Use alternative JRE: 


launch: Make 


Cancel 














2-3 JUint 测 试 配置 























关系 型 数据 库 在 性 能 上 总 是 存在 一 些 这 样 那样 的 缺陷 ， 所 以 大 家 有 时 候 在 使 用 传统 关系 型 数据 库 时 ， 会 与 具有 高 效 存 取 功 能 的 缓存 系统 结合 使 用 ， 以 提高 系统 的 访问 性 能 。 在 很 多 流行 的 缓存 系统 
中 ，Redis 是 一 个 不 错 的 选择 。Redis 是 一 种 可 以 持久 存储 的 缓存 系统 ， 是 一 个 高 性 能 的 key-value 数 据 库 ， 它 使 用 键 - 值 对 的 方式 来 存储 数据 。 










































































需要 使 用 Redis， 可 在 工程 的 Maven 配 置 中 加 入 spring-boot-starter-redis 依 赖 ， 如 代码 清单 2-9 所 示 。 其 中 gson 是 用 来 转换 Json 数 据 格 式 的 工具 ，mysql 是 引用 了 上 一 节 的 模块 ， 这 里 使 用 2.1 节 定义 的 
实体 对 象 来 存 取 数据 ， 演 示 在 Redis 中 的 存 取 操 作 。 
































类 ， 如 代码 清和 


存储 格式 。 这 里 使 


代码 清单 2-9 ”Redis 模 块 的 Maven 依 赖 配置 


<dependencies> 
<dependency> 
<groupId>org. springframework.boot</groupId> 
<artifactId>spring-boot-starter-redis</artifactId> 
</dependency> 
<dependency> 
<groupId>com.google.code.gson</groupId> 
<artifactId>gson</artifactId> 
<version>2.2.4</version> 
</dependency> 
<dependency> 
<groupId>springboot .db</groupId> 
<artifactId>mysql</artifactId> 
<version>$ {project .version}</version> 
</dependency> 
</dependencies> 


2.2.2 ”创建 Redis 服 务 类 


Redis 提 供 了 下 列 几 种 数据 类 型 可 供 存 取 : 
“string; 
+ hash; 
+ list; 


“set 及 zset。 














在 实例 中 ,将 使 




















代码 清单 2-10 ”用 户 实体 的 Redis 服 务 类 
@Repository 
public class UserRedis { 

@Autowired 


private RedisTemplate<String, String> redisTemplate; 
public void add (String key, Long time,User user) { 
Gson gson = new Gson(); 
redisTemplate.opsForValue() .set (key, gson.toJson (user), time, TimeUnit. 
MINUTES); 
} 
public void add (String key, Long time, List<User> users) { 
Gson gson = new Gson(); 
redisTemplate.opsForValue () .set (key, gson.toJson(users), time, TimeUnit. 
MINUTES); 


Public User get (String key) { 
Gson gson = new Gson () 7 
User user = null; 
String userJson = redisTemplate.opsForValue () .get (key); 
if(!StringUtils.isEmpty (userJson)) 
user = gson.fromJson (userJson, User.class); 
return user; 


} 
public List<User> getList (String key) { 
Gson gson = new Gson(); 
List<User> ts = null; 
String listJson = redisTemplate.opsForValue () .get (key); 
if(!StringUtils.isEmpty (listJson)) 


ts = gson.fromJson(listJson, new TypeToken<List<User>>(){}.getType()); 


return ts; 
} 
public void delete (String key){ 

redisTemplate.opsForValue () .getOperations () .delete (key); 
} 


string 即 字符 串 的 类 型 来 演示 数据 的 存 取 操作 。 对 于 Redis，Spring Boot 没 有 提供 像 JPA 那 样 相应 的 资源 库 接 
2-10 所 示 。 这 个 服务 类 可 以 存 取 对 象 User 以 及 由 User 组 成 的 列表 List， 同 时 还 提供 了 一 个 删除 的 方法 。 所 有 这 些 方 法 都 是 使 









































RedisTemplate 来 实现 的 。 


， 所 以 只 能 仿照 上 一 节 中 Repository 的 定义 编写 一 个 实体 User 的 服务 





Redis 没 有 表 结 构 的 概念 ， 
Gson 工 ， 












































因为 Redis 使 











所 以 要 实现 MySQL 数 据 库 中 表 的 数据 ( 即 普 通 Java 对 象 映射 的 实体 数 拉 
将 类 对 象 转 换 为 JSON 格 式 的 文本 进行 存储 ， 要 取出 数据 时 ， 再 将 JSON 文 本 数据 转化 为 java 对象。 


了 key-value 的 方式 存储 数据 ， 所 以 存 入 时 要 生成 一 个 唯一 的 key， 而 要 查询 或 者 删除 数据 时 ， 就 可 以 使 




















居 ) 在 Redis 中 存 取 ， 必 须 做 一 些 转换 ， 使 

















这 个 唯一 的 key 进 行 相应 的 操作 。 


JSON 格 式 的 文本 作为 Redis 与 java 普通 对 象 互相 交换 数据 的 





保存 在 Redis 数 据 库 中 的 数据 默认 是 永久 存储 的 ， 可 以 指定 一 个 时 限 来 确定 数据 的 生命 周期 ， 超 过 指定 时 限 的 数据 将 被 Redis 自 动 清除 。 在 代码 清单 2-10 中 我 们 以 分 钟 为 单位 设 定 了 数据 的 存储 期 限 。 














另外 ， 为 了 能 正确 调 


代码 清单 2-11 RedisTemplate 初 始 化 


RedisTemplate， 必 须 对 其 进行 一 些 初始 化 工作 ， 即 主要 对 它 存 取 的 字符 串 进行 一 个 JSON 格 式 的 系列 化 初始 配置 ， 如 代码 清单 2-11 所 示 。 





@Configuration 
public class RedisConfig { 
@Bean 
public RedisTemplate<string, String> redisTemplate( 
RedisConnectionFactory factory) { 
StringRedisTemplate template = new StringRedisTemplate (factory); 


Jackson2JsonRedisSerializer jackson2JsonRedisSerializer = new Jackson2JsonRedisSerializer (Object.class); 


ObjectMapper om = new ObjectMapper (); 

om.setVisibility (PropertyAccessor.ALL, JsonAutoDetect.Visibility.ANY); 
om.enableDefaultTyping (ObjectMapper .DefaultTyping.NON FINAL); 
jackson2JsonRedisSerializer.setObjectMapper (om); 
template.setValueSerializer (jackson2JsonRedisSerializer); 
template.afterPropertiesSet (); 

return template; 





库 服 务 器 的 IP 地 址 和 开放 端 


2.2.3 ”Redis 测 试 








如 果 还 没有 安装 Redis 服 务 器 ， 可 以 参照 本 书 附录 C 提 供 的 方法 安装 ， 然 后 在 工程 的 配置 文件 application.yml 中 配置 连接 Redis 服 务 器 等 参数 ， 如 代码 清单 2-12 所 示 。 























，database 可 以 不 





性 





中 host 和 port 分 别 表示 Redis 数 据 





指定 ， 由 Redis 根 据 存 储 情况 自动 选 定 ( 注 : 测试 时 这 些 配置 是 集成 在 一 个 配置 类 中 实现 的 ) 。 











代码 清单 2-12 ”Redis 配 置 





spring: 
redis: 
# database: 1 
host: 192.168.1.214 
port: 6379 
pool: 
max-idle: 8 
min-idle: 0 
max-active: 8 
max-wait: -1 








现在 编写 一 个 JUint 测 试 程序 ， 来 演示 如 何在 Redis 服 务 器 中 存 取 数 据 ， 如 代码 清单 2-13 所 示 。 测 试 程序 创建 一 个 部 门 对 象 并 将 其 命名 为 “开发 部 。， 创 建 一 个 角色 对 象 并 把 它 命名 为 admin， 创 建 一 个 



















































































户 对 象 并 把 它 命名 为 user， 同 时 设 定 这 个 用 户 属于 “开发 部 ”， 并 把 admin 这 个 角色 分 配给 这 个 用 户 。 接 着 测试 程序 使 
现在 这 个 用 户 的 数据 ， 最 后 使 用 这 个 key 查 询 用 户 ， 并 将 查 到 的 信息 打印 出 来 。 


























代码 清单 2-13 ”Redis 测 试 程序 








类 名 等 参数 生成 一 个 key， 并 使 F 

















这 个 key 清 空 原来 的 数据 ， 然 后 




















这 个 key 存 储 





@RunWith (SpringJUnit4ClassRunner.class) 
@ContextConfiguration (classes = {RedisConfig.class, UserRedis.class}) 
public class RedisTest { 
private static Logger logger = LoggerFactory.getLogger (RedisTest.class); 
@Autowired 
UserRedis userRedis; 
@Before 
public void setup(){ 
Deparment deparment = new Deparment (); 
deparment .setName ("开发 部 "); 
Role role = new Role(); 
role.setName ("admin"); 
User user = new User(); 
user.setName ("user"); 
user.setCreatedate (new Date () ) ; 
User.setDeparment (deparment); 
List<Role> roles = new ArrayList<>() 
roles.add (role); 
user.setRoles (roles); 
userRedis.delete (this.getClass() .getName ()+":userByname:"+user.getName ()); 
userRedis.add (this.getClass () .getName ()+":userByname:"+tuser.getName (), 10L, user); 
i 
@Test 
public void get(){ 
User user = userRedis.get (this.getClass () .getName ()+":userByname: 


User"); 
Assert .notNull (user); 
logger .info ("======User====== name:{}, deparment:{}, role:{}", 
user.getName (), user.getDeparment () .getName () user.getRoles() .get (0) . 
getName () ) 7 


} 





要 运行 这 个 测试 程序 ， 可 以 在 IDEA 的 Run/Debug Configuration 配 置 中 增加 一 个 JUint 配 置 项 目 ， 模 块 选择 redis， 工 作 


dbdemo.redis.test.RedisTest， 并 将 配置 保存 为 redistest。 


























户 的 有 





使 用 Debug 方 式 运行 测试 项 目 redistest。 如 果 测 试 通过 ， 会 输出 一 个 上 

















户 名 、 所 属 部 门 和 拥有 角色 等 简要 信息 ,， 义 














录 选 择 模块 所 在 的 根 


























下 所 示 : 


录 ， 类 选择 这 个 测试 程序 即 








dbdemo .reqdis.test.RedisTest — 


























对 于 Redis 的 使 有 数据 库 的 方法 相 结合 ， 那 样 就 不 用 再 编写 像 上 














， 还 可 以 将 注解 方式 与 调 有 


























2.3 使 用 MongoDB 








在 当前 流行 的 NoSQL 数 据 库 中 ，MongoDB 是 大 家 接触 比较 早 而 且 F 
有 务 管理 机 制 。 
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TT 





2.3.1 MongoDB 依 赖 配置 























在 Spring Boot 中 使 
MongoDB 本 身 的 依赖 之 


JPA 一 样 容易 ， 并 且 同 样 拥有 功能 完善 的 资源 库 。 同 样 的 ， 要 使 
配套 使 用 。 











MongoDB 也 像 使 有 
， 还 需要 一 些 附 加 的 工 









































代码 清单 2-14 ”使 用 MongoDB 的 Maven 依 赖 配置 


<dependencies> 
<dependency> 
<groupId>org.springframework.data</groupId> 
<artifactId>spring-data-mongodb</artifactId> 
</dependency> 
<dependency> 
<groupId>org .pegdown</groupId> 
<artifactId>pegdown</artifactId> 
<version>1.4.1</version> 
</dependency> 
<dependency> 
<groupId>org.springframework.boot</groupId> 
<artifactId>spring-boot-starter-hateoas</artifactId> 
</dependency> 
<dependency> 
<groupId>com. fasterxml .jackson.core</groupId> 
<artifactId>jackson-annotations</artifactId> 
</dependency> 
</dependencies> 


那样 的 服务 类 ， 并 且 使 


得 比较 多 的 数据 库 。MongoDB 是 文档 型 的 NoSQL 数 据 库 ， 











起 来 更 加 简单 ， 这 将 在 后 











的 章节 中 介绍 。 



































MongoDB， 首 先 必须 在 工程 的 Maven 中 引入 它 的 依赖 ， 如 代码 清和 


有 大 数据 量 、 高 并 发 等 优势 ， 但 缺点 是 不 能 建立 实体 关系 ， 而 














也 没 





2-14 所 示 。 除 了 








2.3.2 文档 建 模 











MongoDB 是 文档 型 数据 库 ， 使 用 MongoDB 也 可 以 像 使 用 关系 型 数据 库 那 样 为 文档 建 模 。 如 代码 清单 2-15 所 示 ， 
来 保存 用 户 角色 的 数据 集 ， 还 定义 了 一 个 构造 函数 ， 可 以 很 方便 地 用 来 创建 一 个 用 户 实例 。 

































































代码 清单 2-15 





户 文档 建 模 








为 用 户 文档 建 模 ， 它 具有 用 户 名 、 密 码 、 用 户 名 称 、 邮 箱 和 注册 日 期 等 字段 ， 有 一 个 








@Document (collection = "user") 


public class User 1{ 
QId 
Private String userId; 
@NotNull QIndqexed (uniaue = 
private String username; 
@NotNull 
private String password; 
@NotNull 
private String name; 
@NotNull 
private String email; 
@NotNull 
private Date registrationDate = 
Private Set<String> roles = new HashSet<>() 
public User() { } 
QPersistenceConstructor 


true) 


new Date(); 


public User (String userId, String username, String password, String name, String email, 


Date registrationDate, Set<String> 
this.userId = userId; 
this.username = username; 
this.password = password; 
.name = name; 
.email = email; 
.registrationDate = 
‘roles = roles; 


roles) { 


registrationDate; 





2.3.3 ”文档 持久 化 








MongoDB 也 有 像 使 用 JPA 那 样 的 资源 库 ， 如 代码 清和 


2-16 所 示 ,， 为 





代码 清单 2-16 用户 文档 持久 化 

















户 文档 创建 了 一 个 Repository 接 口 


， 继 承 于 MongoRepository， 实 现 了 文档 持久 化 。 





public interface UserRepository extends MongoRepository<User, String> { 


User findByUsername (String username); 


} 








MongoRepository 的 继承 关系 如 











2-4 所 示 ， 看 起 来 跟 JPA 的 资源 库 的 继承 关系 没有 什么 两 样 ， 它 也 包含 访问 数据 库 的 











功能 。 


Repository 


CrudRepository 


PagineAndSortineRepository 


MongoRepository 





图 2-4 MongoRepository 接 口 继承 关系 

















代码 清单 2-17 是 用 在 测试 中 的 使 用 MongoDB 的 一 个 配置 类 定义 ， 其 中 @PropertySource 指 定 读 取 数 据 库 配置 文件 的 位 置 和 和 名称，@EnableMongoRepositories 启 用 资源 库 并 设 定 定义 资源 库 接口 放 
的 位 置 ， 这 里 使 用 环境 变量 Environment 来 读 取 配置 文件 的 一 些 数据 库 配 置 参 数 ， 然 后 使 用 一 个 数据 库 客户 端 ， 连 接 MongoDB 服 务 器 。 






















































































代码 清单 2-17 TestDataSourceConfig 配 置 类 





@Configuration 
@EnableMongoRepositories (basePackages = "dbdemo.mongo.repositories") 
@PropertySource ("classpath:test .properties") 
public class TestDataSourceConfig extends AbstractMongoConfiguration { 
QAutowired private Environment env; 
QOverride 
public String getDatabaseName (){ 
return env.getRequiredProperty ("mongo.name"); 
} 
QOverride 
@Bean 
public Mongo mongo() throws Exception { 
ServerAddress serverAddress = new ServerAddress (env.getRequiredProperty 
("mongo.host")); 
List<MongoCredential> credentials = new ArrayList<>(); 
return new MongoClient (serverAddress, credentials); 


Ek 


2.3.4 MongoDB 测 试 


如 果 还 没有 安装 MongoDB 服 务 器 ， 可 以 参照 附录 B 的 方法 安装 并 启动 一 个 MongoDB 服 务 器 。 然 后 ， 使 
器 安装 在 本 地 ， 并 使 用 默认 的 数据 库 端口 : 27017。 

















代码 清单 2-18 ”MongoDB 数 据 库 配置 




















如 代码 清单 2-18 所 示 的 配置 方法 配置 连接 服务 器 的 一 些 参数 ， 该 配置 假定 你 的 MongoDB 服 务 





# MongoDB 
mongo.host=localhost 
mongo.name=test 
mongo .Port=27017 























这 样 就 可 以 编写 一 个 JUint 测 试 例子 来 测试 UserRepository 接 口 的 使 用 情况 ， 如 代码 清单 2-19 所 示 。 测 试 例子 首先 使 用 用 户 文档 类 创建 一 个 用 户 对 象 实例 ， 然 后 使 用 资源 库 接口 调 










































































象 保存 到 数据 库 中 ， 最 后 使 用 findAll 方 法 查询 所 有 用 户 的 列表 ， 并 使 用 一 个 循环 输出 用 户 的 简要 信息 。 









































代码 清单 2-19 MongoDB 测 试 








save 方 法 将 用 户 对 









































@RunWith (SpringJUnit4ClassRunner.class) 
@ContextConfiguration (classes = {TestDataSourceConfig.class}) 
@FixMethodOrder 
public class RepositoryTests { 
private static Logger logger = LoggerFactory.getLogger (RepositoryTests.class); 
@SuppressWarnings ("SpringJavaAutowiringInspection") QAutowired 
UserRepository userRepository; 
@Before 
public void setup(){ 
Set<String> roles = new HashSet<>(); 
roles.add ("manage"); 
User user = new User("l","user","12345678", "name", "email@com.cn",new Date(), 
roles); 
userRepository.save (user); 
} 
@Test 
Public void findAll (){ 
List<User> users = userRepository.findAll (); 
Assert .notNull (users); 
for (User user : users){ 
logger.info ("===user=== userid:{}, username:{}, pass:{}, registra 
tionDate:{}", 
user.getUserId(), user.getName(), user.getPassword(), user. 
getRegistrationDate () ) 7 


} 









































现在 可 以 在 IDEA 的 Run/Debug Configuration 配 置 中 增加 一 个 JUint 测 试 项 目 ， 模 块 选择 mongodb， 工 作 目录 选择 模块 所 在 的 工程 根 


dbdemo.mongo.test.RepositoryTests， 并 将 配置 保存 为 mongotest。 



































使 用 Debug 方 式 运行 测试 项 目 mongotest。 如 果 通过 测试 ， 将 输出 查 到 的 用 户 的 简要 信息 ， 如 下 所 示 : 














录 ， 类 选择 上 面 编写 的 测试 例子 ， 即 











dbdemo .mongo.test .RepositoryTests - =—=user=== userid:1, username:name, 
pass:12345678, registrationDate:Tue Jun 07 14:26:02 CST 2016 











这 时 使 用 MongoDB 数 据 库 客户 端 输入 下 面 的 查询 指令 ， 也 可 以 查 到 这 条 文档 的 详细 信息 ， 这 是 一 条 JSON 结 构 的 文本 信息 。 

















> db.user.find() 


{ "id" : "1"，"”class" : "dbdemo.mongo.models.User", "username" : 
"user", "password" : "12345678"，"name" : "name", "email" : "emailQ@com.cn", 
"registrationDate" : ISODate ("2016-04-13T06:27:02.4232")，"roles" : [ "manage" ] } 


2.4 使 用 Neo4j 




















有 没有 既 具 有 传统 关系 型 数据 库 的 优点 ， 又 具备 NoSQL 数 据 库 优势 的 一 种 数据 库 呢 ? Neo4j 就 是 一 种 这 样 的 数据 库 。Neo4j 是 一 个 高 性 能 的 NoSQL 图 数据 
数据 存储 在 一 张 图 上 ， 图 中 每 一 个 节点 的 属性 表示 数据 的 内 容 ， 每 一 条 有 向 边 表示 数据 的 关系 。Neo4j 没 有 表 结 构 的 概念 ， 它 的 数据 用 节点 的 属性 来 表示 。 
































2.4.1 Neo4j 依 赖 配置 























库 ， 并 且 具 备 完全 事务 特性 。Neo4j 将 结构 化 



































在 Spring Boot 中 使 用 Neo4j 非 常 容易 ， 因 为 有 spring-data-neo4j 提 供 了 强大 的 支持 。 首 先 ， 在 工程 的 Maven 管 理 中 引入 Neo4j 的 相关 依赖 ， 如 代码 清单 2-20 所 示 。 











代码 清单 2-20 ”使 用 Neo4j 的 Maven 依 赖 配置 


<dependencies> 
<dependency> 
<groupId>org.springframework.boot</groupId> 
<artifactId>spring-boot-starter-data-rest</artifactId> 
</dependency> 
<dependency> 
<groupId>org.springframework.data</groupId> 
<artifactId>spring-data-neo4j</artifactId> 
<version>4.0.0.RELEASE</version> 
</dependency> 
<dependency> 
<groupId>com.voodoodyne.jackson.jsog</groupId> 
<artifactId>jackson-jsog</artifactId> 
<version>1.1</version> 
<scope>compile</scope> 
</dependency> 
</dependencies> 





2.4.2 ”节点 和 关系 实体 建 模 








一 个 角色 关系 实体 。 它 们 的 实体 -关系 模型 如 图 2-5 所 示 。 这 个 实体 -关系 模型 的 定义 比 起 关系 型 数据 库 的 实体 -关系 模型 的 定义 要 简 重 














虽然 Neo4j 没 有 表 结 构 的 概念 ， 但 它 有 节点 和 关系 的 概念 。 例 如 ， 现 在 有 演员 和 电影 两 个 实体 ， 它 们 的 关系 表现 为 一 个 演员 在 一 部 电影 中 扮演 一 个 角色 .。 忆 
得 多 ， 但 是 它 更 旋 


形象 和 由 


8 么 就 可 以 创建 演员 和 电影 两 个 节点 实体 ， 和 
目 切 地 表现 了 实体 之 间 的 关系 。 更 难能可贵 的 

















是 ， 这 个 实体 -关系 模型 是 可 以 不 经 过 任何 转换 而 直接 存 入 数据 库 的 ， 也 就 是 说 ， 在 Neo4j 图 数据 库 中 保存 的 数据 与 
相同 。 所 以 使 用 Neo4j 数 据 库 ， 将 在 很 大 程度 上 减轻 了 设计 工作 和 沟通 成 本 。 





























图 











2-5 所 示 的 相同 ， 它 仍然 是 一 张 





图 








。 这 对 了 





业务 人 员 和 数据 库 设计 人 员 来 说， 它 的 意义 


演员 角色 2 


图 2-5 Neo4j 实 体 -关系 模型 示例 
























































像 JPA 使 用 了 ORM 一 样 ，Neo4j 使 用 了 对 象 -图 形 映 射 (Object-Graph Mapping，OGM) 的 方式 来 建 模 。 代 码 清单 2-21 是 演员 节点 实体 建 模 ， 使 用 注解 @Jsonldentitylnfo 是 防止 查询 数据 时 引发 递 
归 访 问 效应 ， 注 解 @NodeEntity 标 志 这 个 类 是 一 个 节点 实体 ， 注 解 @Graphld 定 义 了 节点 的 一 个 唯一 性 标识 ， 它 将 在 创建 节点 时 由 系统 自动 生成 ， 所 以 它 是 不 可 缺少 的 。 这 个 节点 预定 义 了 其 他 两 个 属 
性 ，name 和 born。 节 点 的 属性 可 以 随 需要 增加 或 减少 ， 这 并 不 影响 节点 的 使 用 。 





















































代码 清单 2-21 ”演员 节点 实体 建 模 





Q@JsonIdentityInfo (generator=JSOGGenerator .class) 
@NodeEntity 
public class Actor { 

@GraphId Long id; 

private String name; 

Private int born; 

public Actor() { pe 








代码 清单 2-22 是 电影 节点 实体 建 模 ， 注 解 @Relationship 表 示 List<Role> 是 一 个 关系 列表 ， 其 中 type 设 定 了 关系 的 类 型 ，direction 设 定 这 个 关系 的 方向 ，Relationship.INCOMING 表 示 以 这 个 节点 为 
终点 。addRole 定 义 了 增加 一 个 关系 的 方法 。 


代码 清单 2-22 ”电影 节点 实体 建 模 





@JsonIdentityInfo (generator=JSOGGenerator .class) 
@NodeEntity 
public class Movie { 
Q@GraphId Long jd” 
String title; 
String year; 
String tagline; 
@Relationship (type="ACTS_IN", direction = Relationship.INCOMING) 
List<Role> roles = new ArrayList<>(); 
public Role addRole (Actor actor, String name){ 
Role role = new Role(actor,this,name); 
this.roles.add(role); 
return role; 


} 
public Movie() { }eee 




















代码 清单 2-23 是 角色 的 关系 实体 建 模 ， 注 解 @RelationshipEntity 表 明 这 个 类 是 一 个 关系 实体 ， 并 用 type 指 定 了 关系 的 类 型 ， 其 中 @StartNode 指 定 起 始 节点 的 实体 ，@EndNode 指 定 终止 节点 的 实 
体 ， 这 说 明了 图 中 一 条 有 向 边 的 起 点 和 终点 的 定义 。 其 中 定义 了 一 个 创建 关系 的 构造 函数 Role (Actor actor，Movie movie，String name) ， 这 里 的 name 参 数 用 来 指定 这 个 关系 的 属性 。 



































[ 





代码 清单 2-23 ”角色 关系 实体 建 模 





@JsonIdentityInfo (generator=JSOGGenerator .class) 
QRelationshipEntity (type = "ACTS_IN") 
public class Role { 

@GraphId 

Long id; 

String role; 

@StartNode 

Actor actor; 

@EndNode 

Movie movie; 

public Role() { 


} 

Public Role (Actor actor, Movie movie, String name) { 
this.actor = actor; 
this.movie = movie; 
this.role = name; 


} 
http://www.hzcourse.com/resource/readBook?path=/openresources/teach ebook/uncompressed/15925/0EBPS/Text/. .http://www.hzcourse.com/resource/readBook?path=/openresources/teach ek 





2.4.3 ”节点 实体 持久 化 


























像 对 其 他 数据 库 的 访问 和 存 取 等 操作 一 样 ，spring-data-neo4j 提 供 了 功能 丰富 的 资源 库 可 供 调 
24 是 电影 资源 库 接口 的 定义 ， 它 继承 于 GraphRepository 接 口 ， 实 现 了 电影 实体 的 持久 化 。 使 用 相同 方法 可 以 对 演员 的 节点 实体 实现 持久 化 。 关 系 实体 却 不 用 实现 持久 化 ， 当 保存 节点 实体 时 ， 节 点 实体 的 


关系 将 会 同时 保存 。 


















































代码 清单 2-24 ”电影 实体 持久 化 


I 此， 对 于 演员 和 电影 节点 实体 ， 可 以 创建 它们 对 应 的 资源 库 接口 ， 实 现实 体 的 持久 化 。 代 码 清单 2- 





Q@Repository 

public interface MovieRepository extends GraphRepository<Movie> { 
Movie findByTitle (@Param("title") String title); 

} 








出 





















































其 中 GraphRepository 接 口 的 继承 关系 也 遵循 了 Spring Boot 资 源 库 定义 的 规则 ， 即 使 用 与 JPA 相 同 的 标准 规范 ， 所 以 它 同 样 包含 使 用 数据 库 的 丰富 功能 ， 如 图 2-6 所 示 。 


Reposltory 


CrudReposltory 


PagingAndSortingeRepository 


GraphRepository 





图 2-6 ”GraphRepository 接 口 继承 关系 


2.4.4 Neo4j 测 试 





























代码 清单 2-24 是 Neo4j 的 数据 库 配 置 类 ， 其 中 @Enable-TransactionManagement 启 用 了 事务 管理 ，@EnableNeo4jRe-positories 启 用 了 Neo4j 资 源 库 并 指定 了 我 们 定义 的 资源 库 接 口 的 位 置 ， 在 重 载 
的 SessionFactory 函 数 中 设 定 了 定义 实体 的 位 置 ， 这 将 促使 定义 的 实体 被 作为 域 对 象 导入 ，RemoteServer 设 定 连 接 Neo4j 服 务 器 的 URL、 用 户 名 和 密码 ， 这 些 参数 要 依据 安装 Neo4j 服 务 器 的 情况 来 设置 。 
如 果 还 没有 安装 Neo4j 服 务 器 ， 可 参考 附录 A 的 方法 进行 安装 ， 安 装 完成 后 启动 服务 器 以 备 使 用 。 






























































代码 清单 2-25 ”Neo4j 配 置 类 





@Configuration 
@EnableTransactionManagement 
QEnableNeo4jRepositories (basePackages = { "dbdemo.neo4j.repositories" }) 
public class Neo4jConfig extends Neo4jConfiguration { 
QOverride 
Public Neo4jServer neo4jServer() { 
return new RemoteServer ("http://192.168.1.221:7474", "neo4j", "12345678"); 


} 
QOverride 
public SessionFactory getSessionFactory() { 
return new SessionFactory ("dbdemo.neo4j.domain™"); 


} 








现在 可 以 编写 一 个 测试 程序 来 验证 和 演示 上 面 编写 的 代码 的 功能 ， 如 代码 清单 2-26 所 示 。 这 个 测试 程序 分 别 创建 了 三 部 电影 和 三 个 演员 ， 以 及 三 个 演员 在 三 部 电影 中 各 自 扮演 的 角色 ， 然 后 按照 电影 标 
题 查 出 一 部 电影 ， 按 照 其 内 在 的 关系 输出 这 部 电影 的 信息 和 每 个 演员 扮演 的 角色 。 这 些 数据 的 内 容 参 照 了 Neo4j 帮 助 文档 中 提供 的 示例 数据 。 




















代码 清单 2-26 ”使 用 Neo4j 的 JUint 测 试 程序 





Q@RunWith (SpringJUnit4ClassRunner.class) 
@ContextConfiguration (classes 
public class MovieTest { 
private static Logger logger = LoggerFactory.getLogger (MovieTest.class); 
QAutowired 
MovieRepository movieRepository; 
@Before 
Public void initData(){ 

movieRepository.deleteAll (); 

Movie matrixl = new Movie(); 

matrixl.setTitle("The Matrix"); 

matrix]l .setYear ("1999-03-31"); 

Movie matrix2 = new Movie(); 

matrix2.setTitle("The Matrix Reloaded"); 

matrix2.setYear ("2003-05-07"); 

Movie matrix3 = new Movie(); 

matrix3.setTitle ("The Matrix Revolutions"); 

matrix3.setYear ("2003-10-27"); 

Actor keanu = new Actor(); 

keanu. setName ("Keanu Reeves"); 

Actor laurence = new Actor(); 

laurence.setName ("Laurence Fishburne"); 

Actor carrieanne = new Actor(); 

Carrieanne.setName ("Carrie-Anne Moss"); 

matrixl .addRole (keanu, 

matrixl .addRole (laurence, "Morpheus"); 

matrixl .addRole (carrieanne, "Trinity"); 

movieRepository.save (matrix1) 7 

RAssert .notNull (matrixl .getId()); 

matrix2.addRole (keanu, 

matrix2.addRole (laurence, "Morpheus"); 

matrix2.addRole (carrieanne, "Trinity"); 

movieRepository.save (matrix2); 

Assert .notNull (matrix2.getId()); 

matrix3.addRole (keanu, 

matrix3.addRole (laurence, "Morpheus"); 

matrix3.addRole (carrieanne, "Trinity"); 

movieRepository.save (matrix3); 

Assert .notNull (matrix3.getId()); 


} 


QTest 
public void get(){ 
Movie movie = movieRepository.findByTitle ("The Matrix"); 
Assert .notNull (movie); 


logger .info ("===movie=== movie:{ 
for (Role role : movie.getRoles( 


logger .info(™ 





{Neo4jConfig.class}) 


"Neon) ; 
"Neo"); 


"Neo"); 


}, {}",movie.getTitle(), movie.getYear()); 
4 
actor:{}, 


role:{}", role.getActor() .getName(), role.getRole()); 





在 IDEA 的 Run/Debug Configuration 配 置 中 增加 一 个 JUint 的 配置 项 目 ， 模 块 选择 neo4j， 工 作 目录 选择 模块 所 在 的 根 目录 ， 测 试 程序 选择 MovieTest 这 个 类 ， 并 将 配置 保存 为 neo4jtest。 








使 











Debug 模 式 运行 测试 项 目 neo4jtest， 如 果 测 试 通过 ， 将 在 控制 台中 看 到 输出 查询 的 这 部 电影 和 所 有 演员 及 其 扮演 的 角色 ， 如 下 所 示 : 











movie:The Matrix, 


1999-03-31 


actor:Keanu Reeves, role:Neo 
actor:Laurence Fishburne, role:Morpheus 
actor:Carrie-Anne Moss, role:Trinity 





这 时 ， 在 数据 库 客户 端的 控制 台 上 ， 单 击 左面 侧 边 栏 的 关系 类 型 ACTS IN， 可 以 看 到 一 个 很 酷 的 


色 ， 如 图 





2-7 所 示 。 








图 形 ， 


图 中 每 部 电影 和 每 个 演员 是 一 





人 


节点 ， 节 点 的 每 条 有 向 边 代表 了 这 个 演员 在 那 部 电影 中 扮演 的 角 





图 2-7 演员 和 电影 的 角色 关系 





陋 











2.5 水 结 





























这 一 章 ， 我 们 一 口气 学 习 使 用 了 4 种 数据 库 : MySQL、Redis、MongoDB、Neo4j， 除 了 Redis 以 外 ， 都 使 用 了 由 Spring Boot 提 供 的 资源 库 来 访问 数据 库 并 对 数据 库 执行 了 一 般 的 存 取 操 作 。 可 以 看 
出 ,在 Spring Boot 框 架 中 使 用 数据 库 非常 简单 、 容易 ， 这 主要 得 益 于 Spring Boot 资 源 库 的 强大 功能 ，Spring Boot 资 源 库 整合 了 第 三 方 资源 ， 它 把 复杂 的 操作 变 成 简单 的 调用 ， 它 把 所 有 “辛苦 、 繁 重 的 
事情 ”都 包揽 了 ， 然 后 将 “微笑 和 鲜花 ” 献 给 了 我 们 。 为 此 ， 我 们 应 该 说 声 谢谢 ， 谢 谢 开 发 Spring Boot 框 架 及 所 有 第 三 方 提供 者 的 程序 员 们 ， 因 为 有 了 他 们 辛勤 的 付出 ， 才 有 了 我 们 今天 使 用 上 的 便利 。 










































































本 章 实例 的 完整 代码 可 以 在 IDEA 中 直接 从 GitHub 中 检 出 : https://github.com/chenfromsz/spring-boot-db.git。 









































本 章 实例 都 是 使 用 JUint 的 方式 来 验证 的 ， 为 了 能 使 用 友好 的 界面 来 运行 应 用 ， 下 一 章 将 介绍 如 何 使 用 Thymeleaf 来 进行 界面 设计 。 


















































第 3 章 Spring Boot 界 面 设计 
























































Spring Boot 框 架设 计 Web 显 示 界面 ， 我 们 还 是 使 用 MVC (Model View Controller， 模 型 -视图 -控制 器 ) 的 概念 ， 将 数据 管理 、 事 件 控制 和 界面 显示 进行 分 层 处 理 ， 实 现 多 层 结 构 设 计 。 界 面 设 
计 ， 即 视图 的 设计 ， 主 要 是 组 织 和 处 理 显示 的 内 容 ， 界 面 上 的 事件 响应 最 终 交 给 了 控制 器 进行 处 理 ， 由 控制 器 决定 是 否 调用 模型 进行 数据 的 存 取 操 作 ， 然 后 再 将 结果 返回 给 合适 的 视图 显示 。 

















































































































本 章 的 实例 工程 使 用 分 模块 管理 ， 如 表 3-1 所 示 ， 即 将 数据 管理 独立 成 为 一 个 工程 模块 ， 专 门 负责 数据 库 管 理 方面 的 功能 。 而 界面 设计 模块 主要 负责 控制 器 和 视图 设计 方面 的 功能 。 

















表 3-1 ”实例 工程 模块 列表 


功 能 
实现 使 用 Neo4j 数据 库 
控制 器 和 视图 设计 


项 目 
数据 管理 模块 
界面 设计 模块 





3.1 模型 设计 














数据 管理 模块 实现 了 MVC 中 模型 的 设计 ， 主 要 负责 实体 建 模 和 数据 库 持久 化 等 方面 的 功能 。 在 本 章 的 实例 中 ， 将 使 用 上 一 章 的 Neo4 数 据 库 的 例子 ， 对 电影 数据 进行 管理 。 回 顾 一 下 ， 有 两 个 节点 实体 
(电影 和 演员 ) 和 一 个 关系 实体 (角色 ) 。 其 中 ， 关 系 实体 体现 了 节点 实体 之 间 的 关系 ， 即 一 个 演员 在 一 部 电影 中 扮演 一 个 角色 。 实 体 建 模 和 持久 化 与 上 一 章 的 实现 差不多 。 只 不 过 为 了 适应 本 章 的 内 容 ， 
电影 节点 实体 和 角色 关系 实体 的 建 模 在 属性 上 做 了 些许 调整 。 另 外 针对 Neo4j 数 据 库 的 分 页 查询 也 做 了 一 些 调整 和 优化 。 



































3.1.1 节点 实体 建 模 




















如 代码 清单 3-1 所 示 ， 在 电影 节点 实体 建 模 中 做 了 一 些 调整 ， 即 增加 一 个 photo 属 性 ， 用 来 存放 电影 剧照 ， 并 将 关系 类 型 更 改 为 “扮演 ”。 需 要 注意 的 是 ，Neo4j 还 没有 日 期 格式 的 数据 类 型 ， 所 以 在 读 
取 日 期 类 型 的 数据 时 ， 使 用 注解 @DateTimeFormat 进 行 格式 转换 ， 而 在 保存 时 ， 使 用 注解 @DateLong 将 它 转 换 成 Long 类 型 的 数据 进行 存储 。 






































代码 清单 3-1 电影 节点 实体 建 模 





@JsonIdentityInfo (generator=JSOGGenerator .class) 
@NodeEntity 
public class Movie { 
@GraphId 
Long id; 
private String name; 
private String photo; 
Q@DateLong 
Q@DateTimeFormat (pattern = "yyyy-MM-dd HH:mm:ss") 
private Date createDate; 
@Relationship (type=" 扮 演 "，direction = Relationship.INCOMING) 
List<Role> roles = new ArrayList<>(); 
public Role addRole (Actor actor, String name){ 
Role role = new Role(actor,this,name); 
this.roles.add (role); 
return role; 
} 
public Movie() { } 
http://www.hzcourse.com/resource/readBook?path=/openresources/teach ebook/uncompressed/15925/0EBPS/Text/..http://www.hzcourse.com/resource/readBook?path=/openresources/teac 





3.1.2 ”关系 实体 建 模 


影 实体 对 应 的 角色 关系 实体 建 模 的 关系 类 型 也 同样 做 了 调整 而 改 为 “扮演 ”， 如 代码 清单 3-2 所 示 。 


代码 清单 3-2 角色 关系 实体 建 模 





@JsonIdentityInfo (generator=JSOGGenerator .class) 
QRelationshipEntity (type = "扮演 ") 
public class Role { 

@GraphId 

Long id; 

String name; 

@StartNode 

Actor actor; 

@EndNode 

Movie movie; 

public Role() { 





3.1.3 ”分 页 查询 设计 




















对 于 新 型 的 Neo4j 数 据 库 来 说 ， 由 于 它 的 资源 库 遵循 了 JPA 的 规范 标准 来 设计 ， 在 分 页 查询 方面 有 的 地 方 还 不 是 很 完善 ， 所 以 在 分 页 查询 中 ， 设 计 了 一 个 服务 类 来 处 理 ， 如 代码 清单 3-3 所 示 。 其 中 ,使 


























Class<T> 传 入 调用 的 实体 对 象 ， 使 用 Pageable 传 入 页 数 设 定 和 排序 字段 设 定 的 参数 ， 使 用 Filters 传 入 查询 的 一 些 节点 属性 设 定 的 参数 。 

















代码 清单 3-3 ”Neo4j 分 页 查询 服务 类 





Q@Service 
Public class PagesService<T> { 
@Autowired 
private Session session; 
public Page<T> findAll (Class<T> clazz, Pageable pageable, Filters filters){ 
Collection data = this.session.]loadAll (clazz, filters, convert 
(pageable.getSort () ) new Pagination (pageable.getPageNumber(), pageable.getPageSize()), 1); 
return updatePage (pageable, new ArrayList (data)); 


http://www.hzcourse.com/resource/readBook?path=/openresources/teach ebook/uncompressed/15925/0EBPS/Text/. .http://www.hzcourse.com/resource/readBook?path=/openresources/teach ek 





3.2 ”控制 器 设计 









































怎样 将 视图 上 的 操作 与 模型 一 一 数据 管理 模块 联系 起 来 ， 这 中 间 始 终 是 控制 器 在 起 着 通信 桥梁 的 作用 ， 它 响应 视图 上 的 操作 事件 ， 然 后 根据 需要 决定 是 否 访问 数据 管理 模块 ， 最 后 再 将 结果 返回 给 合适 
的 视图 ， 由 视图 处 理 显示 。 下 面 将 按照 电影 控制 器 的 设计 来 说 明 控制 器 中 增删 查 改 的 实现 方法 ， 演 员 控制 器 的 设计 与 此 类 似 ， 不 再 缆 述 。 


























3.2.1 新建 控 制 器 














[ 





接收 新 建 电影 的 请 求 ， 以 及 输入 一 部 电影 的 数据 后 的 最 后 提交 ， 由 新 建 控制 器 进行 处 理 。 在 控制 器 上 将 执行 两 个 操作 ， 第 一 个 操作 将 返回 一 个 新 建 电影 的 视图 ， 第 二 个 操作 接收 界面 中 的 输入 数据 ， 并 
调用 数据 管理 模块 进行 保存 ， 如 代码 清单 3-4 所 示 。 其 中 ，create 函 数 将 返回 一 个 新 建 电影 的 视图 ， 它 不 调用 数据 管理 模块 ，save 函 数 将 需要 保存 的 数据 通过 调用 数据 管理 模块 存储 至 数据 库 中 ， 并 返回 一 个 
成 功 标志 。 注 意 ， 为 了 简化 设计 ， 将 电影 剧照 的 图 片 文 件 做 了 预定 义 处 理 。 










































































代码 清单 3-4 ”新 建 电影 控制 器 





@RequestMapping ("/new") 

Public ModelAndView create (ModelMap model){ 
String[] files = {"/images/movie/ 西 游记 .jpg", "/images/movie/ 西 游记 续集 .jpg"}; 
model .addAttribute ("files",files); 
return new ModelaAndView ("movie/new"); 

E 

@RequestMapping (value="/save", method = RequestMethod.POST) 

public String save (Movie movie) throws Exception{ 
movieRepository.save (movie); 
logger.info ("新 增 ->ID={}"，movie.getId()); 
return "1"; 





3.2.2 ”查看 控制 器 




















网 


查看 一 个 电影 的 详细 信息 时 ， 控 制 器 首先 使 用 请 求 的 电影 ID 向 数据 管理 模块 请 求 数据 ， 然 后 将 取得 的 数据 输出 到 一 个 显示 视 








上 ， 如 代码 清单 3-5 所 示 。 





代码 清单 3-5 ”查看 电影 控制 器 





@RequestMapping (value="/ {id}") 
Public ModelAndView show (ModelMap model, @PathVariable Long id) { 
Movie movie = movieRepository.findone (id); 
model .addAttribute ("movie",movie); 
return new ModelAndView ("movie/show"); 


3.2.3 ”修改 控制 器 

















若 要 实现 对 电影 的 修改 及 保存 操作 ， 需 要 先 将 电影 的 数据 展示 在 视图 界面 上 ， 然 后 接收 界面 的 操作 ， 调 用 数据 管理 模块 将 更 改 的 数据 保存 至 数据 库 中 ， 如 代码 清单 3-6 所 示 。 其 中 ， 为 了 简化 设计 ， 将 剧 
照 中 的 图 片 文件 和 电影 角色 名 称 做 了 预定 义 处 理 。 修 改 数据 时 ， 由 于 从 界面 传 回 的 电影 对 象 中 ， 丢 失 了 其 角色 关系 的 数据 (这 是 OGM 的 缺点 ) ， 所 以 再 次 查询 一 次 数据 库 ， 以 取得 一 个 电影 的 完整 数据 ， 然 
后 再 执行 修改 的 操作 。 









































代码 清单 3-6 ”修改 电影 控制 器 


@RequestMapping (value="/edit/{id}") 

public ModelAndView update (ModelMap model, Q@PathVariable Long id){ 
Movie movie = movieRepository.findone (id); 
String[] files = {"/images/movie/ 西 游记 .jpg","/images/movie/ 西 游记 续集 .jpg"}; 
String[] rolelist = {" 唐 僧 ", "孙悟空 ", "猪八戒 "," 沙 僧 "}; 
Iterable<Actor> actors = actorRepository.findAll (); 
model .addAttribute ("files",files); 
model .addAttribute ("rolelist",rolelist); 
model .addAttribute ("movie",movie); 
model .addAttribute ("actors",actors); 
return new ModelAndView ("movie/edit"); 

i 

@RequestMapping (method = RequestMethod.POST, value="/update") 

public String update (Movie movie, HttpServletRequest request) throws Exception{ 
String rolename = request.getParameter ("rolename"); 
String actorid = request .getParameter ("actorid"); 
Movie old = movieRepository.findone (movie.getId()); 
old.setName (movie.getName ()); 
old.setPhoto (movie.getPhoto()); 
old.setCreateDate (movie.getCreateDate ()); 
if(!StringUtils.isEmpty (rolename) && !StringUtils.isEmpty(actorid)) { 

Actor actor = actorRepository.findone (new Long (actorid)); 
old.addRole (actor, rolename); 

} 
movieRepository.save (ol1d); 
logger.info ("修改 ->ID="+old.getId()); 
return "1"; 





3.2.4 ”删除 控制 器 











删除 电影 时 ， 从 界面 上 接收 电影 的 ID 参 数 ， 然 后 调用 数据 管理 模块 将 电影 删除 ， 如 代码 清单 3-7 所 示 。 














代码 清单 3-7 ”删除 电影 控制 器 





@RequestMapping (value="/delete/{id}",method = RequestMethod.GET) 
public String delete (@PathVariable Long id) throws Exception{ 
Movie movie = movieRepository.findone (id); 
movieRepository.delete (movie); 
logger.info ("删除 ->ID="+id)， 
retarn "i 





3.2.5 ”分 页 查询 控制 器 








列表 数据 的 查询 使 



































了 3.1.3 节 定义 的 分 页 查询 服务 类 。 


代码 清单 3-8 ”电影 分 页 查询 控制 器 


分 页 的 方法 ， 按 提供 的 查询 字段 参数 、 页 码 、 页 大 小 及 其 排序 字段 等 











数据 管理 模块 进行 查询 ， 然 后 返回 一 个 分 页 对 象 Page， 如 代码 清单 3-8 所 示 。 这 里 的 分 页 查询 





@RequestMapping (value="/1List") 
public Page<Movie> list (HttpServletRequest request) throws Exception{ 
String name = request .getParameter ("name"); 
String page = request .getParameter ("page"); 
String size = request .getParameter ("size"); 
Pageable pageable = new PageRequest (Page==nul1? 0: Integer.ParseInt (page), 
size==null? 10:Integer.parselInt (size), 
new Sort (Sort.Direction.DESC, 
Filters filters = new Filters(); 
if (!StringUtils.isEmpty(name)) { 
Filter filter = new Filter("name", name); 
filters.add (filter); 


mid")); 


return pagesService.findAll (Movie.class, pageable, filters); 





3.3 ”使 用 Thymeleaf 模 板 











完成 了 模型 和 控制 器 的 设计 之 后 ， 接 下 来 的 工作 就 是 视 











设计 了 。 在 视图 








设计 中 主要 使 




















Thymeleaf 模 板 来 实现 。 在 进行 视图 设计 之 前 ， 先 了 解 一 下 Thymeleaf 模 板 的 功能 。 




































































Thymeleaf 是 一 个 优秀 的 面向 Java 的 XML/XHTML/HTML 5 页 面 模板 ， 并 : 
3.3.1 Thymeleaf 配 置 
使 用 Thymeleaf 模 板 ， 首 先 ， 必 须 在 工程 的 Maven 管 理 中 引入 它 的 依赖 : 














代码 清单 3-9 Thymeleaf 依 赖 配置 


有 丰富 的 标签 语言 和 函数 。 使 








Spring Boot 框 架 进 行 界面 设计 ， 一 般 都 会 选择 Thymeleaf 模 板 。 





“spring-boot-starter-thymeleaf”， 如 代码 清单 3-9 所 示 。 





<dependency> 
<groupId>org.springframework.boot</groupId> 
<artifactId>spring-boot-starter-thymeleaf</artifactId> 
</dependency> 





























其 次 ， 必 须 配置 使 用 Thymeleaf 模 板 的 一 些 参数 。 在 一 般 的 Web 项 目 中 都 会 使 



































以 指定 其 他 路 径 ， 其 他 一 些 参数 的 设置 其 实 是 使 用 了 Thymeleaf 的 默认 设置 。 

















如 代码 清和 


























在 实例 中 ， 为 了 更 方便 将 项 目 发 布 成 ar 文件， 我 们 将 使 











Thymeleaf 自 动 配置 中 的 默认 配置 选项 ， 即 只 


3-10 所 示 的 配置 ， 其 中 ，prefix 指 定 了 HTML 文 件 存放 在 webapp 的 /WEB-INF/views/ 目 录 下 面 ， 或 者 也 可 











在 资源 文件 夹 resoueces 中 增加 一 个 templates 目 录 即 可 ， 这 个 目录 上 














来 存放 HTML 文 件 。 








代码 清单 3-10 Thymeleaf 配 置 


spring: 
thymeleaf: 

prefix: /WEB-INF/views/ 
suffix: 
mode: 
encoding: UTF-8 
content-type: text/html 
cache: false 





[3 如 果 工 程 中 增加 了 Thymeleaf 的 依赖 ， 而 没有 进行 任何 配置 ， 或 者 增加 默认 目录 ， 


3.3.2 Thymeleaf 功 能 简介 








在 HTML 页 面 上 使 

















启动 应 用 时 就 会 报错 。 


Thymeleaf 标 签 语言 ， 用 一 个 简单 的 关键 字 “th” 来 标注 。 使 用 Thymeleaf 标 签 语 言 的 典型 例子 如 下 : 





<h3 th:text="${actor.name}"></h3> 
<img th:src="@{/images/1l0ogo.png}"/> 














其 中 ，th: text 指 定 了 在 标签 <h3> 中 显示 的 文本 ， 它 的 值 来 














自 于 关键 字 “$” 所 引 











的 内 存 变 

















，th : src 设 定 了 标签 <img> 的 








出 了 Thymeleaf 的 一 些 主要 标签 和 函数 。 











片 文件 的 链接 地 址 ， 既 可 以 是 绝对 路 径 ， 也 可 以 是 相对 路 径 。 下 面 列 





:text， 显 示 文 本 。 

:utext: 和 th:text 的 区 别 是 针对 "unescaped text"。 
:attr: 设置 标签 属性 。 

:if or th:unless: 条 件 判断 语句 。 
:switch，th:case: 选择 语句 。 
:each: 循环 语句 。 

#dates: 日 期 函数 。 

#calendars: 日 历 函 数 。 


: 雪 数 。 
串通 数 。 
象 函数 。 








#1ists: 列表 函数 。 











本 章 的 实例 工程 将 在 视 











设计 中 使 











Thymeleaf 的 下 列 几 个 主要 功能 ， 而 有 关 Thymeleaf 的 详细 说 明和 介绍 可 以 访问 它 的 官方 网 站 http://www.thymeleaf.org/， 以 获得 更 多 的 帮助 。 











1. 使 用 功能 函数 


























Thymeleaf 有 一 些 日 期 功能 函数 、 字 符 串 函数 、 数 组 函数 、 列 表 函 数 等 ， 代 码 清单 3-11 是 Thymeleaf 使 用 日 期 函数 的 一 个 例子 ，#dates.format 是 一 个 日 期 格式 化 的 使 用 实例 ， 它 将 电影 的 创建 日 期 格 
式 化 为 中 文 环境 的 使 用 格式 “yyyy-MM-dd HH: mm: ss”。 









































代码 清单 3-11 Thymeleaf 使 用 函数 











th:value="$ {movie.createDate} ? ${#dates.format (movie.createDate, 'yyyy-MM-dd HH:mm:ss')} :''" 











2. 使 用 编程 语 




















Thymeleaf 有 条 件 语句 、 选 择 语 句 、 循 环 语句 等 。 代 码 清单 3-12 使 用 each 循 环 语句 来 显示 一 个 数据 列表 ， 即 在 下 拉 列 表 框 中 使 用 循环 语句 来 显示 所 有 的 演员 列表 。 














代码 清单 3-12 th: each 循环 





<select name=" 







torid" id="actorid"> 

<option value=""> 选 择 演员 </option> 

<option th:eadl actor:${actors}" 
th:value="$ {actor.id}" 
th:text="${actor.name}"> 

</option> 

</select> 











3. 使 用 页 





框架 模板 











对 
























































Thymeleaf 的 页 面 框架 模板 是 比较 优秀 的 功能 。 预 先 定义 一 个 layout， 它 具有 页 眉 、 页 脚 、 提 示 栏 、 导 航 栏 和 内 容 显示 等 区 域 ， 如 代码 清单 3-13 所 示 。 其 中 ，layout: fragment="prompt" 是 一 个 提示 
栏 ， 它 可 以 让 引用 的 视图 替换 显示 的 内 容 ; fragments/nav: : nav 是 一 个 导航 栏 并 指定 了 视图 文件 ， 也 就 是 说 它 不 能 被 引用 的 视图 蔡 换 内 容 ; layout: fragment= "content" 是 一 个 主要 内 容 显示 区 域 ， 它 
也 能 由 引用 的 视图 替换 显示 内 容 ; fragments/footer: : footer 是 一 个 页 脚 定义 并 且 也 指定 了 视图 文件 ， 即 不 被 引用 的 视图 替换 显示 内 容 。 这 样 设计 出 来 的 页 面 模板 框架 如 图 3-1 所 示 。 

















































































































四 












































代码 清单 3-13 ”layout 模 板 





<div class="headerBox"> 
<div class="topBox"> 
<div class="topLogo f-left"> 
<a href="#"><img th:src="@{/images/l0go.png}"/></a> 
</div> 
<div class="new-nav"> 
<h3> 电 影 频道 </h3> 
</div> 
</div> 
</div> 
<div class="locationLine" layout:fragment=" prompt "> 
当前 位 置 : 首页 &gt; <em> 页 面 </em> 
</div> 
<table class="globalMainBox"> 
<tr> 
<td class="columLeftBox" V> 
<div th:replace="fragments/nav :: nav"></div> 
</td> 
<td class="whiteSpace"></td> 
<td class="rightColumnBox" v> 
<div layout:fragment="content"></div> 
</td> 
</tr> 
</table> 
<div class="footBox" th:replace="fragments/footer :: footer"></div> 


| | 


图 3-1 页 面 框架 模板 




















有 了 页 面 模板 之 后 ， 就 可 以 在 一 个 主页 面 视图 上 引用 上 面 的 layout， 并 替换 它 的 提示 栏 prompt 和 主要 内 容 显 示 区 域 content， 其 他 页 眉 、 页 脚 和 导航 栏 却 保持 同样 的 内 容 ， 如 代码 清单 3-14 所 示 。 这 样 
就 可 以 设计 出 一 个 使 用 共用 模板 的 具有 统一 风格 特征 的 界面 。 















































代码 清单 3-14 “使 用 layout 模 板 的 视图 设计 





<html xmlns:th="http://www.thymeleaf.org" layout:decorator="fragments/layout">… 

<div class="locationLine" layout:fragment=" prompt "> 当前 位 置 : 首页 &gt; <em > 电影 管理 </em> 

</div> 

<div class="statisticBox w-782" layout:fragment="content"> 

http://www.hzcourse.com/resource/readBook?path=/openresources/teach ebook/uncompressed/15925/0EBPS/Text/. .http://www.hzcourse.com/resource/readBook?path=/openresources/teach ek 
</div> 


3.4 ”视图 设计 








视图 设计 包括 列表 视图 、 新 建 视图 、 查 看 视图 、 修 改 视图 和 删除 视图 设计 等 5 个 方面 有 关 数 据 的 增删 查 改 的 内 容 。 






























































我 们 知道 ， 视 图 上 的 数据 存 取 不 是 直接 与 模型 打交道 ， 而 是 通过 控制 器 来 处 理 。 在 视图 中 对 于 控制 器 的 请 求 ， 大 多 使 用 Query 的 方式 来 实现 。jQuery 是 一 个 优秀 的 JavaScript 程 序 库 ， 并 且 具 有 很 好 的 
兼容 性 ， 几 乎 兼容 了 现 有 的 所 有 浏览 器 。 



























































下 面 的 视图 设计 将 以 电影 的 视图 设计 为 例 说 明 ， 演 员 的 视图 设计 与 此 类 似 ， 不 再 歼 述 。 























3.4.1 列表 视图 设计 





















































影 的 列表 视图 是 电影 视图 的 主页 ， 它 引用 了 3.3 节 使 用 Thymeleaf 设 计 的 页 面 框架 模板 layout.html， 在 这 里 主要 实现 对 数据 的 分 页 查询 请 求 和 列表 数据 显示 ， 并 提供 了 一 部 电影 的 新 建 、 查 看 、 修 改 
和 删除 等 超 链接 。 
1. 分 页 设计 



































电影 的 列表 视图 的 分 页 设计 使 用 了 “jquery.paginationjs” 分 页 插件 ， 编 写 如 代码 清单 3-15 所 示 的 脚本 ， 其 中 getOpt 定 义 了 分 页 工具 条 的 一 些 基 本 属性 ，pageaction 通 过 “./list” 调 用 控制 器 取得 分 
页 数据 列表 ， 人 fillData 函 数 将 列表 数据 填充 到 HTML 控 件 tbodyContent 中 。 














代码 清单 3-15 ”分 页 设计 的 js 编码 





// 分 页 的 参数 设置 
Var getOpt = function(){ 
var opt = { 


items per page: 10, // 每 页 记录 数 

num display entries: 3, // 中 间 显示 的 页 数 ， 上 默认 为 10 
current page:0, // 当前 页 

num edge entries:1, // 头 尾 显示 的 页 数 ， 默 认为 0 


link to :"javascript:void(0)", 
prev text:" 上 页 "， 
next_text:" 下 页 "， 

load first page:true, 

show total info:true ， 


Show first last:true, 

firet text:" 首 页 "， 

last text:" 尾 页 "， 

hasSelect:false, 

callback: pageselectCallback // 回调 函数 
} 
return opt; 


} 
// 分 页 开始 
Var currentPageData = null ; 
Var pageaction = function(){ 
$.get('./list?t='+new Date() .getTime(),{ 
name:$ ("#name") .val () 
}, Eunction (data) { 
currentPageData = data.content; 
$(".pagination") .pagination (data.totalElements, getOpt()); 
Ds 
} 
var pageselectCallback = function (page index, jq, size){ 
if (currentPageData!=null1){ 
fillData (currentPageData); 
currentPageData = null; 
J}else 
$.get('./list?t='+new Date () .getTime(),{ 
size:size,page:page index,name:$ ("#name") .val () 
}, function (data) { 
fillData (data.content); 
]) 


} 
// 填充 分 页 数据 
function fillData (data) { 
var $list = $('#tbodyContent') .empty (); 
$.each (data, function (k,v) { 
Var html = "" »} 
html += '<tr> '+ 
'<td>'+ (v.id==null?'':v.id) +'</td>' + 
‘<td>'+ (v.name==null?'':v.name) +'</td>' + 
'<td>'+ (v.createDate==null1?'': getSmpFormatDateByLong (v.create 
Date, true)) +'</td>' ; 
html += '<td><a class="c-50a73f mlr-6" href="javascript:void(0)" onclick= 
"detail(\''+ V.id+t"'\') "> 查看 </a><a class="c-50a73f mlr-6" href= 
"javascript:void(0)" onclick="edit(\''+ Vv.id+t'\') "> 修改 </a><a class="c-50a73f 
mlr-6" href="javascript:void(0)" onclick="del (\''+ Vv.id+t"'\') "> 删除 </a></td>" 7 
html +=</tr> 7 
$list.append ($ (html)); 
]) 
// 分 页 结束 





2. 列 表 页 面 设计 

















电影 列表 的 显示 页 面 主要 定义 了 列表 字段 的 名 称 和 提供 显示 数据 内 容 的 控件 ID， 即 tbodyContent， 如 代码 清单 3-16 所 示 。 








代码 清单 3-16 ”电影 列表 页 面 HTML 编 码 





<!DOCTYPE html> 
<html xmlns:th="http://www.thymeleaf.org" layout:decorator="fragments/layout"> 
<head> 
<title> 电 影 管理 </title> 
<link th:href="@{/scripts/pagination/pagination.css}" rel="stylesheet" type="text/css" /> 
<link th:href="@{/scripts/artDialog/default.css}" rel="stylesheet" type="text/css" /> 
<link th:href="@{/scripts/My97DatePicker/skin/WdatePicker.css}" rel="stylesheet" type="text/css" /> 
<link th:href="@{/styles/index.css}" rel="stylesheet" type="text/css"/> 
<script th:src="@{/scripts/pagination/jquery.pagination.js}"></script> 
<script th:src="@{/scripts/jquery.smartselect-1.1.min.js}"></script> 
<script th:src="@{/scripts/My97DatePicker/WdatePicker.js}"></script> 
<script th:src="@{/scripts/movie/list.js}"></script> 
</head> 
<body> 
<div class="locationLine" layout:fragment="prompt"> 
当前 位 置 : 首页 &gt; <em > 电影 管理 </em> 



















</div> 

<div class="statisticBox w-782" layout:fragment="content"> 
<form id="queryForm" method="get"> 
<div class="radiusGrayBox782"> 





<div class="radiusGrayTop782"></div> 
<div class="radiusGrayMid782"> 
<div class="dataSearchBox forUserRadius"> 
<ul> 
<label class="preInpTxt 
<input type="text" class: 
holder=" 按 电影 名 称 搜索 "id="name" name="name"/> 
</1i> 
li 
<a href="javascript:void(0)" class="blueBtn-62X30 f-right" 
id="searchBtn"> 查 询 </a> 


eft"> 电 影 名 称 </label> 
np-list f-left w-200" place 





</1i> 
</ul> 
</div> 
</div> 
</div> 
</form> 


<div class="newBtnBox"> 

<input type="hidden" id="m ck" /> 

<a id="addBtn" class="blueBtn-62X30" href="javascript:void(0)"> 新 增 </a> 
</div> 
<div class="dataDetailList mt-12"> 

<table id="results" class="dataListTab"> 





<thead> 

<tr> 
<th>ID</th> 
<th> 电 影 </th> 
<th> 出 版 日 期 </th> 
<th> 操 作 </th> 

</tr> 

</thead> 

<tbody id="tbodyContent"> 

</tbody> 

</table> 


<div class="tableFootLine"> 
<div class="pagebarList pagination"/> 
</div> 
</div> 
</div> 
</body> 
</html> 





3. 列 表 视图 设计 效果 

















影 数据 列表 视图 设计 的 最 终 显示 效果 如 图 3-2 所 示 。 




















电影 名 称 按 电影 名 称 搜索 


2016-04-10 17:35:54 


西游 记 续集 2016-04-17 17:37:01 





首页 || 上 -页 ||1|| 下 一 页 || 尾 页 | 共有 2 条 记录 











图 3-2 ”电影 列表 视图 设计 效果 

















3.4.2 ”新 建 视图 设计 


1. 新 建 对 话 框 设 计 

















新 建 电 影 时 ， 在 电影 主页 中 打开 一 个 对 话 框 显示 新 建 的 操作 界面 ， 对 话 框 设计 引用 了 “artDialog.js” 的 对 话 框 插 件 ， 然 后 编写 一 个 脚本 来 打开 对 话 框 ， 如 代码 清单 3-17 所 示 。 其 中 “./new” 是 连接 控 
制 器 的 请 求 URL， 注 意 这 里 使 用 了 相对 路 径 ， 这 个 URL 通 过 “$.get” 请 求 返回 新 建 电 影 的 HTML 页 面 ， 请 求 链接 中 的 ts 参数 传递 的 是 当前 时 间 ， 这 是 为 了 保证 该 链接 是 一 个 全 新 的 链接 ， 以 使 浏览 器 能 显示 


一 个 最 新 的 内 容 页 面 。 























代码 清单 3-17 新建 电 影 对 话 框 设 计 js 编 码 





function create(){ 
$.get("./new", {ts:new Date () .getTime()},function (data) { 
art.dialog({ 

lock:true, 

opacity:0.3, 

title; "新 增 "， 

width:'750px', 

height: "auto'v 

Left *SO%", 

top: '50%', 

content:data, 

esc: true, 

init: function(){ 
artdialog = this; 

] 

close: function(){ 
artdialog = null; 





2 新 建 页 面 设计 























新 建 电影 的 页 面 设计 ， 如 代码 清单 3-18 所 示 ， 这 里 只 是 部 分 HTML 编 码 ， 其 中 的 日 期 控件 使 用 “WdatePickerjs” 揪 件 来 实现 。 对 于 一 部 电影 来 说 ， 我 们 需要 输入 名 称 、 剧 照 和 日 期 三 个 属性 ， 其 中 剧 
照 的 图 片 下 拉 列表 框 使 用 “imageselectjs” 图 片 下 拉 列 表 框 插件 来 实现 ， 并 且 为 了 简化 设计 ， 剧 照 中 的 图 片 文件 使 用 了 预先 定义 的 文件 ， 这 里 只 要 选择 使 用 哪 一 个 图 片 即 可 。 




























































































代码 清单 3-18 ”新 建 电影 页 面 HTML 编 码 





<link th:href="@{/styles/imageselect.css}" rel="stylesheet" type="text/css" /> 
<script th:src="@{/scripts/imageselect.js}"></script> 
<script th:src="@{/scripts/movie/new.js}"></script> 
<form id="saveForm" action="./save" method="post"> 
<table class="addNewInfList"> 
<tr> 
<th> 名 称 </th> 
<td><input class="inp-list w-200 clear-mr f-left" type="text" id= 
"name" name="name" maxlength="120" /></td> 
<th> 剧 照 </th> 
<td width="240"> 
<select name="photo" 
<option th:each=" 







th:value= 
th:text="${file}"> 
</option> 
</select> 
</td> 
</tr> 
<tr> 
<th> 日 期 </th> 
<td> 


<input onfocus="WdatePicker ({dateFmt:'yyyy-MM-dd HH:mm:ss'})" 
type="text" class="inp-list w-200 clear-mr f-left" id="createDate" name="createDate"/> 
</td> 


</tr> 
</table> 
<div class="bottomBtnBox"> 
<a class="btn-93X38 saveBtn" href="javascript:void(0) "> 确定 </a> 
<a class="btn-93X38 backBtn" href="javascript: closeDialog()"> 返 回 </a> 
</div> 
</form> 
<script type="text/javascript"> 
$ (document) .ready (function(){ 


$ 


Hz 
</script> 


('select [name=photo] ') .ImageSelect ({dropdownWidth:425}); 





3. 表 单 验证 与 提交 设计 


递 使 








验证 新 建 电 影 表 单 的 提交 时 使 用 “jquery.validate.min.js” 插 件 中 的 验证 方法 来 实现 ， 如 代码 清单 3-19 所 示 。 保 存 时 调用 经 典 的 “$.ajax” 方 式 利用 POST 方 法 进行 提交 ， 其 中 headers: {"Content- 
type": "application/x-www-form-urlencoded; charset=UTF-8"} 用 于 保证 数据 在 传输 过 程 中 中 文字 符 的 正确 性 。 在 表单 验证 中 ， 只 对 name 和 createDate 两 个 























用 一 个 表单 序列 化 函数 serialize () 来 实现 ， 它 将 表单 控件 上 的 对 象 序列 化 为 一 个 个 含有 “ 键 - 值 ”对 的 字符 串 进行 提交 。 


代码 清单 3-19 “新建 电影 中 表单 验证 和 提交 的 js 编码 





属性 进行 简单 的 非 空 验证 ， 表 单 的 参数 传 








$ (function() { 
$('#saveForm') .validate ({ 


} 


rules: { 
name :{required:true}, 
createDate :{required:true} 
},messages:{ 
name :{required:" 必 填 "}， 
createDate :{required:" 必 填 "} 


D); 
$('.saveBtn') .click (function (){ 
if($('#saveForm') .valid()){ 


$.ajax({ 
type: "POST", 
url: "./save", 
data: $("#saveForm") .serialize(), 
headers: {"Content-type": "application/x-www-form-urlencoded; 


charset=UTF-8"}, 


success: function (data) { 


if (data == 1) { 
alert ("保存 成 功 "); 
pageaction(); 
closeDialog (); 

} else { 


alert (data); 


’ 
error:function (data) { 
Var e; 
$.each (data, function (v) { 
a 


alert (e) 
]) 


Jlelse{ 


alert (' 数 据 验证 失败 ， 请 检查 ! '); 





4. 新 建 视图 





设计 效果 











新 建 电 影 的 视图 设计 最 后 的 显示 效果 如 图 3-3 所 示 。 


























图 3-3 新建 电 影视 图 设计 效果 图 











3.4.3 ”查看 视图 设计 








1. 查 看 对 话 框 设计 
在 电影 的 主页 中 单 击 一 部 电影 的 查看 链接 ， 将 打开 一 个 查看 电影 的 对 话 框 ， 对 话 框 的 设计 如 代码 清单 3-20 所 示 ， 其 中 “./{id}” 是 提取 数据 的 链接 ， 它 将 向 控制 器 请 求 数据 ， 并 以 HTML 页 面 方式 显示 出 











来 。 


代码 清单 3-20 ”查看 电影 对 话 框 js 编码 





function detail (id){ 
$.get("./"+id, {ts:new Date() .getTime()},function (data) { 
art.dialog({ 
lock:true, 
opacity:0.3, 
title: "查看 信息 "， 
width:'750px', 
height: "auto'v 
left; '50%', 
top: '50%', 
content:data, 
esc: true, 
init: function(){ 
artdialog = this; 
] 
close: function (){ 
artdialog = null; 





2. 查 看 页 面 设计 









































期 数据 需要 进行 格式 化 ， 而 演员 表 则 使 用 Thymeleaf 中 的 一 个 “th: each” 循 环 语句 来 输出 。 





影 查看 页 面 的 设计 ， 即 将 数据 展示 出 来 的 HTML 编 码 ， 如 代码 清单 3-21 所 示 ， 需 


代码 清单 3-21 ”电影 查看 页 面 HTML 编 码 





<div class="addInfBtn"> 
<h3 class="itemTit"><span> 电 影 
<table class="addNewInfList"> 
tr 
<th> 名 称 </th> 
<td width="240"><input class="inp-list w-200 clear-mr f-left" type= 
"text" th:value="${movie.name}" id="name" name="name" maxlength="16" /></td> 
<th> 日 期 </th> 
<tds 
<input onfocus="WdatePicker ({dateFmt:'yyyy-MM-dd HH:mm:ss'})" type="text" class="inp-list w-200 clear-mr f-left" th:value="${movie.createDate} ? ${#qdates .forma 
</td> 
</tr> 
<tr> 
<th> 剧 照 </th> 
<td width="240"> 
<img th:src="${movie.photo}"/> 





信息 </span></h3> 





</td> 

<th> 演 员 表 </th> 

<td width="240"> 
<ul> 


<1li th:each="role:${movie.roles}" th:text="${role.actor. 
name}+' 饰 '+${role.name}"></1i> 
</ul> 
</td> 
/Ly 
</table> 
<div class="bottomBtnBox"> 
<a class="btn-93X38 backBtn" href="javascript:closeDialog (0) "> 返回 </a> 
</div> 
</div> 





3. 查 看 视图 的 设计 效果 





电影 查看 视图 设计 最 终 完成 的 效果 如 图 3-4 所 示 。 
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图 3-4 查看 电影 视图 设计 效果 图 

















3.4.4 修改 视图 设计 


1. 修 改 对 话 框 设 计 








在 电影 的 主页 中 修改 一 部 电影 ， 首 先 打开 一 个 修改 电影 的 对 话 框 ， 这 个 对 话 框 的 设计 如 代码 清单 3-22 所 示 。 其 中 通过 “$.get” 访 问 “./edit/{id}y” 取 得 数据 和 修改 视图 的 HTML 页 面 元 素 。 





代码 清单 3-22 ”修改 电影 对 话 框 js 编码 


function edit (id){ 
$.get("./edit/"+id, {ts:new Date () .getTime () }, function (data) { 
art.dialog({ 

lock:true, 

opacity:0.3, 

title; "修改 "， 

width:'750px', 

height: 'auto', 

left: '50%', 

top: "SU" 

content:data, 

esc: true, 

init: function(){ 
artdialog = this; 

bs 

close: function (){ 
artdialog = null; 
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在 修改 界面 上 ， 还 增加 了 “增加 角色 ”和 “选择 演员 ”的 编辑 项 。 为 了 简化 设计 这 里 的 角色 名 称 我 们 也 使 用 了 预先 定义 的 数据 。 








代码 清单 3-23 ”修改 电影 页 面 HTML 编 码 


的 页 面 设计 如 代码 清单 3-23 所 示 ， 其 中 剧照 的 下 拉 列 表 框 中 增加 了 “选中 ”的 代码 : th: selected="${tmovie.photo= =file}"， 即 如 果 电 影 中 的 剧照 与 下 拉 框 列表 中 的 剧照 相同 ， 则 选中 





<link th:href="@{/styles/imageselect.css}" rel="stylesheet" type="text/css" /> 
<script th:sr: {/scripts/imageselect .js}"></script> 
<script th:src="@{/scripts/movie/edit.js}"></script> 
<form id="saveForm" method="post"> 
<input type="hidden" name="id" id="id" th:value="$ {movie.id}"/> 
<div class="addInfBtn" > 
<h3 class="itemTit"><span> 编 辑 信 息 </span></h3> 
<table class="addNewInfList"> 
有 
<th> 电 影 名 称 </th> 
<td width="240"><input class="inp-list w-200 clear-mr f-left" type= 
"text" th:value="$ {movie.name}" id="name" name="name" maxlength="16" /></td> 
<th> 电 影 剧 照 </th> 
<td width="240"> 
<select name="photo" id="photo"> 
<option th:each="file:${files}" 
th:value="${file}" 
th:text="${file}" 
th:selected="$ {movie.photo == file}"> 
</option> 
</select> 
</td> 
</tr> 
EY 
<th> 出 版 日 期 </th> 
<td> 
<input onfocus="WdatePicker({dateFmt:'yyyy-MM-dd HH:mm:ss'})" 
type="text" class="inp-list w-200 clear-mr f-left" th:value="${movie.createDate} ? ${#dates.format (movie 
</td> 
</tr> 
<tr> 
<th> 增 加 角色 </th> 
<td width="240"> 
<select name="rolename" id="rolename"> 
<option value=""> 增 加 角色 </option> 
<option th:each="role:${rolelist}" 

















th:value="${role}" 
th:text="${role}"> 
</option> 
</select> 
</td> 
<th> 选 择 演员 </th> 








<td width="240"> 
<select name="actorid" i actorid"> 
<option value=""> 选 择 演员 </option> 
<option th:eac actor:${actors}" 












th:value="$ {actor.id}" 
th:text="${actor.name}"> 
</option> 
</select> 
</td> 
</tr> 
</table> 


<div class="bottomBtnBox"> 





<a class="btn-93X38 saveBtn" href="javascript:void(0) "> 确定 </a> 
<a class="btn-93X38 backBtn" href="javascript:closeDialog (0) "> 返回 </a> 
</div> 
</div> 
</form> 


<script type="text/javascript"> 
$ (document) .ready (function (){ 
$ ('select [name=photo] ') .ImageSelect ({dropdownWidth:425}); 
]) 
</script> 


.CreateDate, 'yyyy-MM-dd HH:mm:ss')} 


:1 id="createDate" 


name 一 


createDat 





3. 修 改 视图 的 设计 效果 











最 终 完成 的 修改 电影 视图 的 显示 效果 如 图 3-5 所 示 。 




















3.4.5 ”删除 视图 设计 


1. 删 除 确认 对 话 框 


如 果 有 删除 的 操作 ， 首 先 





西游 记 














图 3-5 ”修改 电影 视图 设计 效果 图 






































代码 清单 3-24 ”删除 确认 对 话 框 js 编码 


























给 出 确认 提示 框 ， 只 有 用 户 单 击 确定 后 才能 删除 数据 ， 否 则 将 不 做 任何 操作 。 确 认 提示 框 是 调用 了 Windows 中 的 确认 对 话 框 ， 如 代码 清单 3-24 所 示 。 





function del (id){ 
if(!confirm(" 您 确定 删除 此 记录 吗 ? ") ){ 


return false; 


} 
$.get("./delete/"+id, {ts:new Date () .getTime () } ,function (data) { 


if (data==1) { 
alert ("删除 成 功 "); 
pageaction(); 

}else{ 

alert (data); 
} 

及 





2. 删 除 确认 设计 效果 





执行 删除 操作 的 确认 效果 如 图 3-6 所 示 。 


SS 


入口 














localhost 显示 : 


您 确定 删除 此 记录 吗 ? 


运行 与 发 布 








图 3-6 ”删除 电影 确认 对 话 框 效 果 





























本 章 实例 工程 的 完整 代码 可 以 通过 IDEA 从 GitHub 中 检 出 : https://github.com/chenfromsz/spring-boot-ui.git。Spring Boot 需 要 一 个 启动 程序 作为 应 上 








程序 ， 如 代码 清单 3-25 所 示 。 使 








这 个 入 口 





程序 ， 就 可 以 调试 和 发 布 工程 了 。 


的 入 














， 在 webui 模 块 中 ， 我 们 设计 了 一 个 


代码 清单 3-25 “Web 应 用 启动 主 程序 


Package com.test.webui; 
import org.springframework.boot.SpringApplication; 
import org.springframework.boot.autoconfigure.SpringBootApplication; 
import org.springframework.context .annotation.ComponentScan; 
Q@SpringBootApplication 
@ComponentScan (basePackages = "com.test") 
public class WebuiApp { 

public static void main (String[] args) { 

SpringApplication.run (WebuiApp.class, args); 
} 








通过 在 IDEA 中 打开 Run/Debug Configurations 对 话 框 ， 增 加 一 个 Spring Boot 配 置 ， 模 块 选择 webui， 工 作 目录 选择 模块 webui 所 在 的 路 径 ， 主 程序 选择 WebuiApp， 并 将 配置 保存 为 webui。 然 后 在 
1DEA 中 运行 该 配置 项 目 webui， 即 可 启动 应 用 进行 调试 。 






































如 果 要 发 布 应 用 ， 可 以 在 IDEA 的 Run/Debug Configurations 对 话 框 中 增加 一 个 Maven 打 包 配 置 项 目 ， 工 作 目 录 选 择 工程 的 根 目 录 ， 命 令 行 中 输入 指令 : clean package-D skipTests， 并 将 配置 保存 
为 mvn。 然 后 运行 这 个 配置 项 目 mvn 进 行 打包 ， 打 包 成 功 后 ， 在 “webui/target” 目 录 中 将 生成 webui-1.0-SNAPSHOT.jar。 要 运行 这 个 程序 包 ， 可 以 打开 一 个 命令 行 窗口 ， 将 路 径 切 换 到 webui-1.0- 
SNAPSHOT.jar 所 在 的 目录 ， 使 用 下 列 指令 即 可 运行 应 用 。 



























































java -jar webui-1.0-SNAPSHOT.jar 

















最 后 可 使 用 下 面 的 URL 进 行 访问 : 





http://localhost 





在 实例 中 增加 了 一 些 数 








居 之 后 ， 在 Neo4j 数 据 库 客户 端 中 单 击 “ 扮 演 ” 关 系 ， 也 可 以 看 到 电影 和 演员 的 关系 | 


网 











， 如 图 3-7 所 示 。 











图 3-7 电影 与 演员 关系 图 


3.6” 处 结 





















































本 章 介 绍 了 使 用 MVC 的 多 层 结构 方式 ， 以 及 在 Spring Boot 进 行 Web 界 面 设计 的 方法 ， 并 且 使 有 
































Thymeleaf 模 板 设计 了 一 个 Web 应 用 的 页 面 框架 。Web 界 面 设计 的 一 些 细节 ， 更 多 的 是 使 用 了 HTML 编 
码 和 JavaScript 脚 本 ， 而 HTML 离 不 开 CSS 的 支持 ，JavaScript 更 是 借助 于 jQuery 及 其 各 种 插件 的 功能 。 读 者 如 需 深 入 了 解 这 方面 的 知识 和 技术 ， 可 查找 相关 的 知识 进行 学 习 和 研究 。 这 里 主要 使 
Thymeleaf 模 板 工具 来 设计 整体 界面 以 及 组 织 和 处 理 数据 的 显示 。 
















































































有 了 显示 界面 之 后 ， 对 数据 库 的 操作 就 更 为 方便 和 直观 了 。 下 一 章 将 介绍 如 何 使 用 一 些 技术 手段 来 提升 访问 数据 库 的 性 能 ， 以 及 怎样 扩展 访问 数据 库 的 功能 。 








第 4 章 ”提高 数据 库 访问 性 能 














使 用 关系 型 数据 库 的 应 用 系统 的 性 能 瓶颈 最 终 还 是 数据 库 。 随 着 业务 的 迅速 增长 ， 数 据 量 会 不 断 增 大 ， 会 逐渐 暴露 出 关系 型 数据 库 的 弱点 ， 即 性 能 大 幅 下 降 。 提 升 关系 型 数据 库 的 访问 性 能 是 开发 者 的 
人 迫切 任务 。 下 面 从 程序 开发 角度 ， 对 提升 数据 库 的 访问 性 进行 介绍 和 探讨 。 
































本 章 的 实例 工程 使 用 了 分 模块 的 方式 设计 ， 各 个 模块 的 功能 如 表 4-1 所 示 。 





表 4-1 实例 工程 模块 列表 


扩展 功能 模块 程序 集成 JPA 功能 扩展 和 Redis 配置 等 
数据 管理 模块 MySQL 实体 建 模 和 持久 化 等 


页 功名 
l 
Web 应 用 模块 Web 应 用 Web 应 用 实例 





4.1 使 用 Druid 





Druid 是 一 个 关系 型 数据 库 连接 池 ， 它 是 阿里 巴巴 的 一 个 开源 项 目 。Druid 支 持 所 有 JDBC 兼 容 的 数据 库 ， 包 括 Oracle、MySQL、Derby、PostgreSQL、SQL Server、H2 等 。Druid 在 监控 、 可 扩展 性 、 
稳定 性 和 性 能 方面 具有 明显 的 优势 。 通 过 Druid 提 供 的 监控 功能 ， 可 以 实时 观察 数据 库 连 接 池 和 SQL 查询 的 工作 情况 。 使 用 Druid 连 接 池 ， 在 一 定 程度 上 可 以 提高 数据 库 的 访问 性 能 。 











4.1.1 配置 Druid 依 赖 



































可 以 从 http://mvnrepository.com/ 中 查找 Druid 的 依赖 配置 ， 找 到 合适 的 版 本 ， 然 后 复制 其 中 Maven 的 配置 到 实例 工程 的 扩展 功能 模块 dpexpan 中 。 图 4-1 是 我 们 查 到 的 结果 ， 使 用 的 是 1.0.18 版 本 。 
4-1 中 的 HomePage 是 Druid 的 源 代码 链接 地 址 。 
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Druid 


An ]DBC datasource Implementation. 


Alibaba Group 
https://github.com/alibaba/druid 
(Mar 13, 2016) 


View 


Download from central (JAR) (2.0 MB) 


1-— http://mvnrepository. com/artifact/com. alibaba/ druid --> 
<dependency> 
《groupId>com. alibaba/eroupId> 
<artifactId>druidcyartifactId> 
《yersion21.0. 18C/version> 
fdependency> 





图 4-1 查找 Druid 的 依赖 配置 


4.1.2 ”关于 XML 配置 


























使 用 Spring 开发 框架 时 ，XML 配 置 是 经 常 使 用 的 一 种 配置 方法 ， 其 中 数据 源 配置 就 是 使 用 XML 配置 中 的 一 种 。 代 码 清单 4-1 是 一 个 使 用 Druid 连 接 池 的 XML 配置 。 使 用 Spring Boot 框 架 也 能 使 用 XML 配 
， 只 要 在 程序 入 口 使 用 一 个 注解 ， 如 @ImportResource ({"classpath: spring-datasource.xml"}) ， 即 可 导入 XML 配置 。 但 是 ，Spring Boot 不 推荐 这 样 使 用 ， 而 是 集中 在 配置 文件 
application.properties 或 application.yml 中 进行 配置 。 




































































代码 清单 4-1 XML 数 据 源 配 置 





<bean id="dataSource" class="com.alibaba.druid.pool.DruidDataSource" init-method="init" destroy-method="close"> 
<!-- 驱动 名 称 --> 
<property name="DriverClassName" value="com.mysql.jdbc.Driver" /> 
<!-- JDBC 连 接 串 --> 
<property name="url" value="jdbc:mysql:// localhost:3306/test?useUnicode=true&amp;characterEncoding=utf-8" /> 
<!-- 数据 库 用 户 名 称 --> 
<property name="username" value="root" /> 
<!-- 数据 库 密码 --> 
<property name="password" value="12345678" /> 
<!-- 连接 池 最 大 使 用 连接 数量 -> 


<!-- 初始 化 大 小 -> 

<property name="initialSize" value="5" /> 

<!-- 获取 连接 最 大 等 待 时 间 一 -> 

<property name="maxWait" value="60000" /> 

<!-- 连接 池 最 小 空 闪 --> 

<property name="minIdle" value="2" /> 

<!-- 逐 出 连接 的 检测 时 间 间 隔 --> 

<property name="timeBetweenpvictionRunsMillis" value="60000" /> 
<!-- 最 小 六 
<property name="minEvictableIdleTimeMillis" value="300000" /> 
<!-- 测试 有 效用 的 SQL Query --> 

<property name="validationQuery" value="SELECT 'x'" /> 

<!-- 连接 空闲 时 测试 是 否 有 效 --> 

<property name="testWhileIdle" value="true" /> 

<!-- 获取 连接 时 测试 是 否 有 效 一 -> 

<property name="testOnBorrow" value="false" /> 

<!-- 归还 连接 时 是 否 测试 有 效 --> 

<property name="testOnReturn" value="false" /> 

<!-- 配置 监控 统计 拦截 的 filters --> 


<property name="filters" value="stat" /> 


















</bean> 


4.1.3 ”Druid 数 据 源 配 置 





Spring Boot 的 数据 源 配 置 的 默认 类 型 是 org.apache.tomcat.jdbc.pool.DataSource, 为 了 使 




















所 示 。 其 中 ，url、username、password 是 连接 MySQL 服 务 器 的 配置 参数 ， 其 他 一 些 参 数 设 定 Druid 的 工作 方式 。 


代码 清单 4-2 ”Druid 数 据 源 配置 





Druid 连 接 池 ， 可 以 将 数据 源 类 型 更 改 为 com.alibaba.druid.pool.DruidData-Source， 如 代码 清单 4-2 





spring: 
datasource: 

type: com.alibaba.druid.pool.DruidDataSource 
driver-class-name: com.mysql.jdbc.Driver 
url: jdbc:mysql:// localhost:3306/test?characterEncoding=utf8 
username: root 
password: 12345678 
# 初始 化 大 小 ， 最 小 ， 最 大 
initialSize: 5 
minIdle: 5 
maxActive: 20 
# 配置 获取 连接 等 待 超 时 的 时 间 
maxWait: 60000 
# 配置 间隔 多 久 才 进行 一 次 检测 ， 检 测 需要 关闭 的 空闲 连接 ， 单 位 是 毫秒 
timeBetweenEvictionRunsMillis: 60000 
# 配置 一 个 连接 在 池 中 的 最 小 生存 时 间 ， 单 位 是 毫秒 
minEvictableIdleTimeMillis: 300000 
validationQuery: SELECT 1 FROM DUAL 
testWhileIdle: true 
testOnBorrow: false 
testOnReturn: false 
# 打开 PSCache， 并 且 指定 每 个 连接 上 PSCache 的 大 小 
PoolPreparedStatements: true 
maxPoolPreparedStatementPerConnectionSize: 20 
# 配置 监控 统计 拦截 的 filters， 去 掉 后 监控 界面 sq1 将 无 法 统计 ，'"wal1' 用 于 防火 墙 
filters: stat,wall,1o0g4j 
# 通过 connectProperties 属 性 来 打开 mergeSql 功 能 ; 慢 SQL 记 录 


connectionProperties: druid.stat.mergeSql=true;druid.stat.slowSqlMillis=5000 


# 合并 多 个 DruidDataSource 的 监控 数据 
#useGlobalDataSourceStat=true 














上 面 配 置 中 的 filters: stat 表 示 已 经 可 以 使 用 监控 过 滤器 ， 这 时 结合 定义 一 个 过 滤器 ， 就 可 以 














@ 注 意 在 Spring Boot 低 版 本 的 数据 源 配置 中 ， 是 没有 提供 设 定数 据 源 类 型 这 一 功能 的 ， 这 相 


4.1.4 ”开启 监控 功能 














来 监控 数据 库 的 使 








情况 。 

















如 果 要 使 用 上 面 这 











开启 Druid 的 监控 功能 ， 可 以 在 应 有 








运行 的 过 程 中 ， 通 过 监控 提供 的 多 维度 数据 来 分 析 使 F 




















配置 方式 ， 就 需要 使 用 自 定义 的 配置 参数 来 实现 。 


数据 库 的 运行 情况 ， 从 而 可 以 调整 程序 设计 ， 以 优化 数据 库 的 访问 性 能 。 


代码 清单 4-3 定 义 了 一 个 监控 服务 器 和 一 个 过 滤器 ， 监 控 服务 器 设 定 了 访问 监控 后 台 的 连接 地 址 为 “/druid/*”， 设 定 了 访问 数据 库 的 白 名 单 和 黑 名 单 ， 即 通过 访问 者 的 IP 地 址 来 控制 访问 来 源 ， 增 加 了 





























数据 库 的 安全 设置 ， 还 配置 了 一 个 





来 登录 监控 后 台 的 














户 druid， 并 将 密码 设置 为 12345678。 





代码 清单 4-3 ”开启 Druid 监 控 功能 








@Configuration 
public class DruidConfiguration { 
@Bean 
public ServletRegistrationBean statViewServle(){ 
ServletRegistrationBean servletRegistrationBean = 
rationBean (new StatViewServlet (),"/druid/*"); 
// IP 白 名 单 
servletRegistrationBean.addInitParameter ("allow", "192.168.1.218,127. 
Od alnyy 
// IP 黑 名 单 (共同 存在 时 ，deny 优 先 于 allow) 
servletRegistrationBean.addInitParameter ("deny", "192.168.1.100"); 
// 控制 台 管理 用 户 
servletRegistrationBean.addInitParameter ("loginUsername", "druid"); 
servletRegistrationBean.addInitParameter ("loginPassword", "12345678"); 
// 是 否 能 够 重 置 数据 
servletRegistrationBean.addInitParameter ("resetEnable", "false"); 
return servletRegistrationBean; 


new ServletRegist 








} 

@Bean 

public FilterRegistrationBean statFilter(){ 
FilterRegistrationBean filterRegistrationBean = 

(new WebStatFilter()); 

// 添加 过 滤 规 则 
filterRegistrationBean.addUrlPatterns ("/*"); 
// 忽略 过 滤 的 格式 


filterRegistrationBean.addInitParameter ("exclusions","*.js,*.gif,*.jpg,*. 


png*.css* .iconr /druid/*"); 
return filterRegistrationBean; 


} 


new FilterRegistrationBean 











开启 监控 功能 后 ， 运 行 应 








在 监控 后 台中 ， 可 以 实时 查看 数据 库 连 接 池 的 情况 ， 每 一 个 被 执行 的 SQL 语句 使 用 的 次 数 和 人 花费 的 时 间 、 并 发 数 等 ， 以 及 一 个 URI 请 求 的 次 数 、 时 间 和 并 发 数 等 情况 。 这 就 为 分 析 一 个 应 


库 的 情况 和 性 能 提供 了 可 靠 、 详 细 的 原始 数据 ， 让 我 们 能 在 一 些 基础 的 细节 上 修改 和 优化 一 个 应 




















时 ， 可 以 通过 网 址 http://localhost/durid/index.html 打 开 控 制 台 ， 输 入 上 面 程序 设 定 的 用 户 名 和 密码 ， 登 录 进 去 ， 可 以 打开 如 





访问 数据 库 的 设计 。 





4-2 所 示 的 监控 后 台 。 
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系统 访问 数据 








eC localhost/druid/sql.html 


Druid Monitor ” 站 页 S SQL 防火 墙 。 Web 应 用 。。 UR 此 控 。。 Session 监 宝 。。 spring 监控 JSON API 


SQL Stat View JSON API 


selectcount(userD_id)a... [0,0,1,0.0,0,0,0] [1,0,0,0,0,0.0,0] 





selectdepariment0_jd as... [40100000 | [2,0,0.0.0,.000] 


Selectroles0_ user_id as [2.0.1.00.0.0.0] B.0.0.0.0.000] 











| selectuser0_id asid1_2... [0,1,0.0.0,0,0,0] | [1,0,0,0,0,0.0.0] 





powered by AlibabaTech & sandzhang & melin & shrek wang 





图 4-2 ”Druid 监 控 后 台 


如 果 需 要 了 解 更 多 有 关 Druid 的 使 用 或 者 下 载 其 源 代码 ， 可 以 访问 https://github.com/alibaba/druid。 


4.2 扩展 JPA 功 能 








使 用 JPA， 在 资源 库 接口 定义 中 不 但 可 以 按照 其 规则 约定 的 方法 声明 各 种 方法 ( 像 在 第 2 章 中 介绍 的 那样 ) ， 也 可 以 使 用 注解 @Query 来 定义 一 些 简单 的 查询 语句 ， 如 代码 清单 4-4 所 示 。 本 节 还 将 介绍 
如 何在 全 局 的 范围 中 ,扩展 JPA 接 口 的 功能 。 

















代码 清单 4-4 ”使 用 @Query 自 定义 查询 





@Repository 
public interface UserRepository extends JpaRepository<User, Long> { 
QQuery ("select 七 from User 七 where 七 .name =?1 and t.email =?2") 
User findByNameAndEmail (String name, String email); 
QQuery ("select t from User t where t.name like :name") 
Page<User> findByName (@Param("name") String name, Pageable pageRequest); 





4.2.1 扩展 JPA 接 口 























首先 创建 一 个 接口 ， 继 承 于 JpaRepository， 并 将 接口 标记 为 @NoRepositoryBean， 以 防 被 当 作 一 般 的 Repository 调 用 ， 如 代码 清单 4-5 所 示 。 接 口 ExpandjJpaRepository 不 仅 扩展 了 JPA 原 来 的 
findoOne、findAll、count 等 方法 ， 而 且 增 加 了 deleteBylds、get-EntityClass、nativeQuery4Map 等 方法 ， 其 中 nativeQuery4Map 用 来 执行 原生 的 复杂 的 SQL 查询 语句 。 


代码 清单 4-5 ”扩展 JPA 接 口 定义 








@NoRepositoryBean 
public interface ExpandJpaRepository<T, ID extends Serializable> extends JpaRepository<T,ID> { 
T findone (String condition, Objecthttp://www.hzcourse.com/resource/readBook?path=/openresources/teach ebook/uncompressed/15925/0EBPS/Text/... objects); 
List<T> findAll (String condition, Objecthttp://www.hzcourse.com/resource/readBook?path=/openresources/teach ebook/uncompressed/15925/0EBPS/Text/... objects); 
List<T> findAll (Iterable<Predicate> predicates, Operator operator); 
List<T> findAll (Iterable<Predicate> predicates, Operator operator, Sort sort); 
Page<T> findAll (Iterable<Predicate> predicates, Operator operator, Pageable 
pageable); 
long count (Iterable<Predicate> predicates, Operator operator); 
List<T> findAll (String condition, Sort sort, Objecthttp://www.hzcourse.com/resource/readBook?path=/openresources/teach ebook/uncompressed/15925/0EBPS/Text/... objects); 
Page<T> findAll (String condition, Pageable pageable, Objecthttp://www.hzcourse.com/resource/readBook?path=/openresources/teach ebook/uncompressed/15925/0EBPS/Text/... objec 
long count (String condition, Objecthttp://www.hzcourse.com/resource/readBook?path=/openresources/teach ebook/uncompressed/15925/0EBPS/Text/... objects); 
void deleteByIds (Iterable<ID> ids); 
Class<T> getEntityClass (); 
List<Map<String,Object>> nativeQuery4Map (String sql); 
Page<Map> nativeQuery4Map (String sql, Pageable pageable); 
Object nativeQuery40bject (String sql); 
} 





这 一 接口 的 所 有 声明 方法 ， 必 须 由 我 们 来 实现 。 为 了 节省 篇 幅 ， 只 列 出 实现 的 部 分 代码 ， 如 代码 清单 4-6 所 示 。 完 整 的 代码 可 以 通过 检 出 实例 工程 查看 。 实 现代 码 中 使 用 了 JPQL 查 询 语言 (Java 
Persistence Query Language) ， 它 是 JPA 的 查询 语句 规范 。 


代码 清单 4-6 ”扩展 JPA 接 口 实现 








public class ExpandJpaRepositoryImpl<T, ID extends Serializable> extends SimpleJpaRepository<T, ID> implements ExpandJpaRepository<T,ID> { 
private final EntityManager entityManager; 
Private final JpaEntityInformation<T, ?> entityInformation; 
public ExpandJpaRepositoryImpl (JpaEntityInformation<T, ?> entityInformation, 
EntityManager entityManager) { 
super (entityInformation, entityManager); 
this.entityManager = entityManager; 
this.entityInformation = entityInformation; 
E 
QOverride 
public T findone (String condition, Objecthttp://www.hzcourse.com/resource/readBook?path=/openresources/teach ebook/uncompressed/15925/0EBPS/Text/... values) { 
if (isEmpty (condition)){ 
throw new NullPointerException (" 条 件 不 能 为 空 !") 7 
} 
T result = null; 
try { 
result = (T) createQuery (condition, values) .getSingleResult (); 
} catch (NoResultException e) { 
e.printStackTrace () 7 
} 


return result; 


QOverride 
public List<T> findAll (Iterable<Predicate> predicates, Operator operator) { 
return new JpqlQueryHolder (predicates, operator) .createQuery () .getResult 
List(); 
} 
QOverrigde 
public List<T> findAll (Iterable<Predicate> predicates, Operator operator, Sort sort) { 
return new JpqlQueryHolder (predicates, operator, sort) .createQuery () .getResult 
List(); 
} 
QOverride 
public Page<T> findAll (Iterable<Predicate> predicates, Operator operator, Pageable 
Pageable) { 
if (pageable==nul11) { 
return new PageImpl<T>( (List<T>) findAll (predicates, operator)); 
} 
Long total = count (predicates, operator); 
Query query = new JpqlQueryHolder (predicates, operator,pageable.getSort ()). 
CreateQuery (); 
query.setFirstResult (pageable.getOffset ()); 
query.setMaxResults (pageable.getPageSize()); 
List<T> content = total > pageable.getOffset () ? query.getResultList () 
Collections.<T> emptyList (); 
return new PageImpl<T> (content, pageable, total); 


http://www.hzcourse.com/resource/readBook?path=/openresources/teach ebook/uncompressed/15925/0EBPS/Text/. .http://www.hzcourse.com/resource/readBook?path=/openresources/teac 











过 





定义 的 接口 继承 于 JpaRepository， 所 以 不 但 具有 自 定义 的 一 些 功能 ， 而 且 拥 有 JPA 原 来 的 所 有 功能 ， 它 的 继承 关系 如 图 4-3 所 示 。 


























Repository 


CrudRepository 


PagineAndSortingRepository 


JpaRepository 


ExpandJpaRepository 


4.2.2 ”装配 自 定义 的 扩展 接口 


自 定义 的 接口 必须 在 程序 启动 时 装配 ， 才 能 正常 使 





























图 4-3 ”扩展 JPA 接 口 的 继承 关系 

















。 首 先 ， 创 建 一 个 装配 类 ExpandJpaRepository-FactoryBean， 继 承 于 JpaRepositoryFactory-Bean，， 





7 所 示 。 其 中 getTargetRepository 返 回 自 定义 的 接口 实现 : ExpandJpaRepositoryImpl。 

















代码 清单 4-7 JPA 扩 展 接口 装配 类 


























来 加 载 














定义 的 扩 | 











展 接 











， 如 代码 清单 4- 





Public class ExpandJpaRepositoryFactoryBean<R extends JpaRepository<T, ID>, T, ID extends Serializable> 
extends JpaRepositoryFactoryBean<R, T, ID> { 
protected RepositoryFactorySupport createRepositoryFactory( 
EntityManager entityManager) { 
return new ExpandJpaRepositoryFactory<T, ID> (entityManager); 
} 
Private static class ExpandJpaRepositoryFactory<T, ID extends Serializable> 
extends JpaRepositoryFactory { 
private final EntityManager entityManager; 
public ExpandJpaRepositoryFactory (EntityManager entityManager) { 
super (entityManager); 
this.entityManager = entityManager; 
} 
protected Object getTargetRepository (RepositoryMetadata metadata) { 
JpaEntityInformation<T, Serializable> entityInformation = (JpaEntity 
Information<T, Serializable>) getEntityInformation (metadata.getDomainType()); 
return new ExpandJpaRepositoryImpl<T, ID>(entityInformation, entity 
Manager); 
} 
protected Class<?> getRepositoryBaseClass (RepositoryMetadata metadata) { 
return ExpandJpaRepositoryImpl.class; 
} 





然后 ， 在 JPA 配 置 类 中 ， 通 过 @EnableJpaRepositories 加 载 定 义 的 装配 类 ExpandJpa-RepositoryFactoryBean， 如 代码 清单 4-8 所 示 。 其 中 ， 


径 ，“com.*.entity” 为 实体 模型 的 路 径 。 
代码 清单 4-8 ” JPA 配置 类 


QOrder (Ordered.HIGHEST PRECEDENCE) 
@Configuration 
@EnableTransactionManagement (proxyTargetClass = true) 





@EnableJpaRepositories (basePackages = "com.**.repository", repositoryFactoryBeanClass = ExpandJpaRepositoryFactoryBean.class) 
Q@EntityScan (basePackages = "com.**.entity") 
public class JpaConfiguration { 

@Bean 


PersistenceExceptionTranslationPostProcessor persistenceExceptionTranslationPostProcessor (){ 
return new PersistenceExceptionTranslationPostProcessor () 7 
E 





“com.s*.repository” 为 定义 接口 的 资源 库 路 














4.2.3 ”使 用 扩展 接口 





























现在 来 做 实体 的 持久 化 ， 这 样 就 可 以 直接 使 用 自 定义 的 扩展 接口 了 。 如 代码 清单 4-9 所 示 ， 资 源 库 接口 UserRepository 继 承 的 就 是 前 面 定义 的 接口 ExpandJpaRepository。 


代码 清单 4-9 ”使 用 扩展 接口 做 持久 化 





@Repository 
public interface UserRepository extends ExpandJpaRepository<User, Long> { 
@Query ("select 七 from User 七 where 七 .name =?1 and t.email =?2") 
User findByNameAndEmail (String name, String email); 
QQuery ("select 七 from User 七 where 七 .name like :name") 
Page<User> findByName (GParam("name") String name, Pageable PageRequest) 










































































PredicateBuilder 来 构造 一 个 查询 参数 的 对 象 ， 它 可 以 包含 更 多 的 查询 参数 。 

















代码 清单 4-10 ”使 用 扩展 JPA 接 口 的 分 页 查询 














使 用 JPA 扩 展 接口 与 使 用 原来 的 JPA 接 口 一 样 ， 调 用 方法 基本 相同 ， 只 不 过 有 些 方法 被 赋予 更 为 丰富 的 功能 ， 可 以 更 加 灵活 地 使 














。 代 和 码 清单 4-10 是 一 个 使 用 扩展 接口 的 分 页 查询 ， 使 












































Q@Service 
Public class UserService { 
@Autowired 
private UserRepository userRepository; 
public Page<User> findPage (UserQo userQo) { 
Pageable pageable = new PageRequest (userQo.getPage(), userQo.getSize(), 
new Sort(Sort.Direction.ASC, "id")); 
PredicateBuilder Pb = new PredicateBuilder (); 
if (!StringUtils.isEmpty(userQo.getName())) { 
Pb.add ("name", "%" + UserQo.getName () + "%", LinkEnum.LIKE); 
} 
if (!StringUtils.isEmpty (userQo.getCreatedateStart())) { 
pb.add ("createdate", userQo.getCreatedateStart (), LinkEnum.GE); 
} 
if (!StringUtils.isEmpty (userQo.getCreatedateEnd())) { 
pb.add ("createdate", userQo.getCreatedateEnd(), LinkEnum.LE); 
} 
return userRepository.findAll (pb.build(), Operator.AND, pageable); 


4.3 ”使 用 Redis 做 缓存 














在 数据 库 使 用 中 ， 数 据 查 询 是 最 大 的 性 能 开销 。 如 果 能 借助 Redis 作 为 辅助 缓存 ， 将 可 以 极 大 地 提高 数据 库 的 访问 性 能 。 使 




















可 以 使 用 注解 的 方式 来 调用 ， 这 种 方式 更 加 简单 ， 代 码 也 更 加 简洁 。 

















需要 注意 的 是 ，Redis 是 一 个 具有 持久 化 功能 的 数据 库 系统 ， 若 使 用 默认 配置 ， 存 取 的 数据 就 会 永久 地 保存 在 磁盘 中 。 如 果 只 是 使 F 




































































Redis 做 缓存 ， 一 方面 可 以 像 第 2 章 介绍 的 使 用 Redis 那 样 调 用 ， 另 一 方面 ， 









































Redis 来 做 缓存 ， 并 不 需要 Redis 永 久保 存 数据 ， 可 以 设 定 在 Redis 保 














存 数据 的 期 限 来 实现 ， 这 样 ， 过 期 的 数据 将 自动 从 Redis 数 据 库 中 清除 。 这 不 但 能 很 好 地 利用 Redis 的 快速 存 取 功 能 ， 而 且 能 彻底 减轻 Redis 的 负担 。 作 为 缓存 使 用 的 数据 ， 最 初 就 是 从 数据 库 中 查询 出 来 的 ， 


所 以 完全 没有 必要 再 做 一 次 永久 保存 。 始 终 让 Redis 保 持 轻装 上 阵 ， 才 能 最 好 地 发 挥 它 的 性 能 优势 。 





4.3.1 使 用 Spring Cache 注 解 





























结构 简单 的 对 象 ， 即 没有 包含 其 他 对 象 的 实体 ， 可 以 使 用 Spring Cache 注 解 的 方式 来 使 用 Redis 缓 存 。 要 使 用 注解 的 方式 调 




















setDefaultExpiration 指 定 了 数据 在 Redis 数 据 库 中 的 有 效 期 限 。 


代码 清单 4-11 Spring Cache 配 置 


@Configuration 
@EnableCaching 























缓存 ， 必 须 在 配置 类 中 

















已 








Spring Cache， 如 代码 清单 4-11 所 示 。 其 中 


public class RedisConfig extends CachingConfigurerSupport { 
@Bean 
public CacheManager cacheManager (@SuppressWarnings ("rawtypes") RedisTemplate 
redisTemplate) { 
RedisCacheManager manager = new RedisCacheManager (redisTemplate); 
manager .setDefaultExpiration(43200);// 12 小 时 
return manager; 

















这 样 ， 就 可 以 在 对 数据 接口 的 调用 中 ， 对 增删 查 改 加 入 如 代码 清单 4-12 所 示 的 注解 ， 自 动 增加 缓存 的 创建 、 修 改 和 删除 等 功能 。 其 中 注解 @Cacheable 为 存 取 缓存 ， 注 解 @CachePut 为 修改 缓存 ， 如 
果 不 存在 则 创建 ， 注 解 @CacheEvict 为 删除 缓存 ， 当 删除 数据 时 ， 如 果 缓 存 还 存在 ， 就 必须 删除 ， 各 个 注解 中 的 value 参 数 是 一 个 key 的 前 缀 ， 并 由 keyGenerator 按 一 定 的 规则 生成 一 个 唯一 标识 。 


























代码 清单 4-12 ”用 注解 方式 使 用 Redis 做 缓存 








QService 
public class RoleService { 
@Autowired 
private RoleRepository roleRepository; 
QAutowired 
private RoleRedis roleRedis; 
@Cacheable (value = "mysql:findById:role", keyGenerator = "simpleKey") 
public Role findById(Long id) { 
return roleRepository.findone (id); 


} 
@CachePut (value = "mysql:findById:role", keyGenerator = "objectId") 
public Role create (Role role) { 

return roleRepository.save (role); 


} 
QCachePut (value = "mysql:findById:role", keyGenerator = "objectId") 
public Role update (Role role) { 

return roleRepository.save (role); 


} 
Q@CacheEvict (value = "mysql:findById:role", keyGenerator = "simpleKey") 
public void delete(Long id) { 
roleRepository.delete (id) 7 
} 


http://www.hzcourse.com/resource/readBook?path=/openresources/teach ebook/uncompressed/15925/0EBPS/Text/. .http://www.hzcourse.com/resource/readBook?path=/openresources/teac 














对 于 key 的 生成 规则 ， 使 用 如 代码 清单 4-13 所 示 的 方法 来 实现 ， 这 里 主要 使 用 了 调用 者 本 身 对 象 的 ID 属性 来 保证 它 的 唯一 性 ， 其 中 simpleKey 和 objectld 都 是 提取 调用 者 本 身 的 类 名 字 和 参数 id 作为 唯一 


标识 。 























代码 清单 4-13 ”生成 cache 的 key 





@Bean 
public KeyGenerator simpleKey(){ 
return new KeyGenerator() { 
QOverride 
public Object generate (Object target, Method method, Objecthttp://www.hzcourse.com/resource/readBook?path=/openresources/teach ebook/uncompressed/15925/0EBPS/Text/. 
StringBuilder sb = new StringBuilder(); 二 
sb.append (target .getClass () .getName ()+":"); 
for (Object obj : params) { 
sb.append (obj .toString()); 


return sb.toString() 7 
]7 


@Bean 
public KeyGenerator objectId!() 
return new KeyGenerator () 
QOverride 
public Object generate (Object target, Method method, Objecthttp://www.hzcourse.com/resource/readBook?path=/openresources/teach ebook/uncompressed/15925/0EBPS/Text/. 
StringBuilder sb = new StringBuilder(); 
sb.append (target .getClass () .getName ()+":"); 
try { 
sb.append (params [0] .getClass () .getMethod ("getId", null). 
invoke (params [0], null) .上 toString ()) 7 
}catch (NoSuchMethodException no){ 
no.printstackTrace (); 
}catch (IllegalAccessException i1){ 
il.printStackTrace (); 
}catch (InvocationTargetException iv){ 
iv.printStackTrace (); 


* 


} 


return sb.tostring(); 


ks 





4.3.2 ”使 用 RedisTemplate 



































由 于 使 用 Spring Cache 注 解 的 方法 使 用 Redis 缓 存 ， 只 能 对 简单 对 象 进行 系列 化 操作 ， 所 以 对 于 像 实体 User 这 样 的 包含 了 一 定 关系 的 复杂 对 象 ， 或 其 他 集合 、 列 表 对 象 等 ， 就 不 能 使 用 简单 注解 的 方法 
来 实现 了 ， 还 要 像 第 2 章 中 介绍 的 方法 那样 使 用 RedisTemplate 来 调用 Redis， 其 使 用 的 效果 和 上 面 使 用 Cache 注 解 的 效果 相同 ， 只 不 过 实现 方法 完全 不 同 。 













































































代码 清单 4-14 使 用 RedisTemplate 实 现 了 对 Redis 的 调用 。 这 种 方式 可 以 很 方便 地 对 列表 对 象 进行 系列 化 ， 在 数据 存 取 时 使 用 Json 进 行 格式 转换 。 这 里 使 用 分 钟 作为 时 间 单 位 来 设 定数 据 在 Redis 中 保存 
的 有 效 期 限 。 



































代码 清单 4-14 ”使 用 RedisTemplate 





Q@Repository 
public class UserRedis { 
@Autowired 
Private RedisTemplate<String, String> redisTemplate; 
public void add (String key, Long time, User user) { 
Gson gson = new Gson(); 
redisTemplate.opsForValue() .set (key, gson.toJson(user), time, TimeUnit. 
MINUTES); 
} 
public void add (String key, Long time, List<User> users) { 
Gson gson = new Gson(); 
redisTemplate.opsForValue () .set (key, gson.toJson(users), time, TimeUnit. 
MINUTES); 
} 


public User get (String key) { 
Gson gson = new Gson(); 
User user = null; 
String json = redisTemplate.opsForValue () .get (key); 
if(!StringUtils.isEmpty (json)) 
user = gson.fromJson(json, User.class); 
return user; 


} 
public List<User> getList (String key) { 
Gson gson = new Gson(); 
List<User> ts = null; 
String listJson = redisTemplate.opsForValue () .get (key); 


if(!StringUtils.isEmpty (listJson)) 
ts = gson.fromJson (listJson, new TypeToken<List<User>>(){}.getType()); 
return ts; 
} 
public void delete (String key){ 
redisTemplate.opsForValue () .getOperations () .delete (key); 
} 





























然后 编写 如 代码 清单 4-15 所 示 的 代码 来 使 用 Redis 缓 存 。 即 在 使 用 原来 数据 库 的 增删 查 改过 程 中 ， 同 时 使 用 Redis 进 行 辅助 存 取 ， 以 达到 提升 访问 速度 的 目的 ， 从 而 缓解 对 原来 数据 库 的 访问 压力 。 这 
样 ， 访 问 一 条 数据 时 ， 首 先 从 Redis 读 取 ， 如 果 存 在 则 不 再 到 MySQL 中 读 取 ， 如 果 不 存 在 再 到 MySQL 读 取 ， 并 将 读 取 的 结果 暂时 保存 在 Redis 中 。 



































代码 清单 4-15 “在 数据 服务 中 使 用 Redis 作 为 辅助 缓存 


QService 
public class UserService { 
@Autowired 
private UserRepository userRepository; 
@Autowired 
private UserRedis userRedis; 
Private static final String keyHead = "mysql:get:user:"; 
Public User findById(Long id) { 
User user = userRedis.get (keyHead + id); 


if(user == null){ 
user = UserRepository.findone (id); 
if (user != null) 


userRedis.add (keyHead + id, 30L, user); 
} 


return user; 


public User create(User user) { 
User newUser = userRepository.save (user); 
if (newUser != null) 
userRedis.add (keyHead + newUser.getId(), 30L, newUser); 
return newUser; 


} 
public User update (User user) { 
if(user != null) { 
userRedis.delete (keyHead + user.getId()); 
userRedis.add (keyHead + user.getId(), 30L, user); 


return userRepository.save (user); 
public void delete(Long id) { 
userRedis.delete (keyHead + id); 
userRepository.delete (id); 
} 















































上 面 使 用 Redis 缓 存 的 两 种 方法 ， 可 以 在 一 个 应 用 中 混合 使 用 。 但 不 管 怎么 使 用 ， 对 于 控制 器 来 说 都 是 完全 透明 的 ， 控 制 器 对 数据 接口 的 调用 还 是 像 以 前 一 样 ， 它 并 不 清楚 数据 接口 后 端 是 否 启用 了 缓 
存 ， 如 代码 清单 4-16 所 示 。 



























































代码 清单 4-16 ”控制 器 使 用 数据 接口 





@Autowired 
private UserService userService; 
@RequestMapping (value="/{id}") 
Public String show (ModelMap model,@PathVariable Long id) { 
User user = userService.findById (id); 
model .addAttribute ("user", user); 
return "user/show"; 

















使 用 缓存 之 后 ， 大 量 的 查询 语句 就 从 原来 的 数据 库 服务 器 中 ， 转 移 到 了 高 效 的 Redis 服 务 器 中 执行 ， 这 将 在 很 大 程度 上 减轻 原来 数据 库 服务 器 的 压力 ， 并 且 提 升 查询 的 反应 速度 和 效率 。 所 以 在 很 大 的 程 
度 上 ， 系 统 性 能 就 得 到 了 很 好 的 改善 。 

















4.4 Web 应 用 模块 




















对 于 上 面 一 些 功能 的 实现 ， 最 后 使 用 一 个 Web 应 用 来 调用 ， 以 验证 使 用 Druid 连 接 池 和 使 用 Redis 缓 存 的 效果 ， 同 时 可 以 体验 使 用 JPA 扩 展 接口 更 为 丰富 的 功能 。 









































4.4.1 引用 数据 管理 模块 





























实例 工程 中 的 Web 应 用 模块 将 引用 数据 管理 模块 ， 而 数据 管理 模块 使 用 了 第 2 章 实 例 工程 中 MySQL 模 块 的 实体 -关系 模型 设计 ， 即 使 用 部 门 、 用 户 和 角色 三 个 实体 ， 如 图 4-4 所 示 。 实 体 的 建 模 还 与 第 2 
中 使 用 的 方法 一 样 ， 没 有 做 任何 修改 。 至 于 实体 的 持久 化 ， 如 前 所 述 ， 只 要 在 原来 的 持久 化 中 改变 资源 库 接口 定义 中 继承 于 自 定 义 的 扩展 接口 即 可 。 


编号 
属 M 用 户 MAM > 


名 称 日 期 
























































涝 














4-4 ”实体 -关系 模型 设计 








4.4.2 ” Web 应 用 配置 

















Web 应 用 的 界面 设计 使 用 第 3 章 的 设计 来 实现 。 这 里 ， 主 要 实现 对 部 门 、 用 户 和 角色 三 个 实体 的 数据 进行 增删 查 改 的 管理 。 





























在 Web 应 用 模块 的 配置 文件 application.yml 中 ， 配 置 连接 MySQL 和 Redis 服 务 器 的 一 些 参数 ， 如 代码 清单 4-17 所 示 。 





代码 清单 4-17 Web 应 用 配置 





server: 
port: 80 
tomcat: 
uri-encoding: UTF-8 
spring: 
datasource: 
type: com.alibaba.druid.pool.DruidDataSource 
driver-class-name: com.mysql.jdbc.Driver 
url: jdbc:mysql:// localhost:3306/test?characterEncoding=utf8 
username: root 
password: 12345678 
# 初始 化 大 小 ， 最 小 ， 最 大 
initialSize: 5 
minIdle: 5 
maxActive: 20 
# 配置 获取 连接 等 待 超时 的 时 间 
maxWait: 60000 
# 配置 间隔 多 久 才 进行 一 次 检测 ， 检 测 需 要 关闭 的 空闲 连 接 ， 单 位 是 毫秒 
timeBetweenEvictionRunsMillis: 60000 
# 配置 一 个 连接 在 池 中 的 最 小 生存 时 间 ， 单 位 是 毫秒 
minEvictableIdleTimeMillis: 300000 
validationQuery: SELECT 1 FROM DUAL 
testwhileIdle: true 
testOnBorrow: false 
testOnReturn: false 
# 打开 PSCache， 并 且 指 定 每 个 连接 上 PSCache 的 大 小 
poolPreparedStatements: true 
maxPoolPreparedStatementPerConnectionSize: 20 
# 配置 监控 统计 拦截 的 filters， 去 掉 后 监控 界面 SQ1 将 无 法 统计 ，'"wal1' 用 于 防火 墙 
filters: stat,wall,1o0g4j 
# 通过 connectProperties 属 性 来 打开 mergeSql 功 能 ; 慢 SQL 记 录 
connectionProperties: druid.stat.mergeSql=true;druid.stat.slowSqlMillis=5000 
# 合并 多 个 DruidDataSource 的 监控 数据 
#useGlobalDataSourceStat=true 
jpa: 
database: MYSQL 
show-sql: true 
## Hibernate ddl auto (validate|create|create-drop|update) 
hibernate: 
ddl-auto: update 
naming-strategy: org.hibernate.cfg.ImprovedNamingStrategy 
properties: 
hibernate: 
dialect: org.hibernate.dialect .MySQLS5Dialect 
## redis 
redis: 
host: 192.168.1.214 
port: 6379 
pool: 
max-idle: 8 
min-idle: 0 
max-active: 8 
max-wait: -1 














启动 应 用 后 ， 运 行 效果 如 图 4-5 所 示 。 除 了 分 页 数据 没有 做 缓存 之 外 ， 其 他 查询 都 做 了 缓存 处 理 。 在 控制 台 上 可 以 看 到 执行 的 SQL 查 询 语 句 ， 一 个 查询 ， 比 如 查看 用 户 ， 如 果 在 控制 台 上 没有 看 到 输出 查 
询 语句 ， 就 可 以 说 明 是 调用 了 Redis 缓 存 。 











DO 




















关于 使 用 缓存 的 情况 ， 也 可 以 登录 安装 Redis 的 服务 器 ， 使 用 下 列 指令 ， 查 看 当前 所 有 的 key。 








#redis-cli 
>keys * 














下 载 一 个 Redis 客 户 端 ， 可 以 更 加 直观 地 查看 Redis 服 务 器 的 情况 ， 如 图 4-6 所 示 。 


























当前 位 置 : 首页 > 用 户 管理 
多 


创建 时 间 








2016-06-07 12:06:30 查看 修改 删除 


首页 || 上 -页 || 1 || 下 -页 || 尾 页 | 共有 1 条 记录 








图 4-5 ”Web 应 用 运行 效果 


RedisStadio 


分 DB-0 (248) Key: Com.test.mysql.service.DepartmentService:19 
四 和 cache Type: string 


@ DD com.test.mysql.service.De ||3ize: 1 


口 Ee re TIL: 43148 (lihrs 59mins 8secs) 
com. test .my: .Se 1 


Value 





图 BB com.test.mysql.service.Ro ["com.test.mysql.entity.Department", {"id":19, "name... 


DD com.test.mysql .servi 
图 回 nysql 
@ DD findById 
DD mysql :findById:dep 
DD mysql :findById:rol 
图 国 get 


© 加 user 和 7 
DD mysql:get:user:1' "id": 19, 
@ "name" : "开发 部 "， 
于 resque "createdate": null 
从 DB-1 (0) 


从 DB-2 (0) 











图 4-6 ”Redis 客 户 端 








4.5 ”运行 与 发 布 


本 章 实例 的 完整 代码 可 以 直接 在 IDEA 中 通过 GitHub 检 出 : https://github.com/chen-fromsz/spring-boot-dbup.git。 








检 出 工程 后 ， 可 以 运行 Web 应 用 模块 website 进 行 测试 。 在 IDEA 的 Run/Configura-tion 中 增加 一 个 Spring Boot 配 置 ， 模 块 选择 website， 工 作 目 录 选 择 website 模 块 所 在 的 路 径 ， 主 程序 选择 
com.test.website.WebApplication， 并 将 配置 保存 为 vebapp。 


在 MySQL 服 务 器 中 创建 一 个 数据 库 : test， 配 置 Web 应 用 模块 website 的 配置 文件 application.yml 中 连接 MySQL 服 务 器 的 url、username、password， 以 及 Redis 的 host 和 port。 然 后 运行 配置 项 目 
webapp， 启 动 完成 后 ， 在 浏览 器 中 打开 网 址 : http://127.0.0.1。 


人 @@ 注 意 “因为 ocalhost 不 能 加 入 Druid 的 监控 服务 器 的 白 名 单 中 ， 所 以 使 用 localhost 可 能 不 能 正常 访问 。 而 使 用 域名 的 方式 是 可 以 的 ， 只 要 把 域名 所 指向 的 IP 加 入 Druid 的 白 名 单 中 即 可 。 


如 果 要 打包 发 布 ， 可 以 在 IDEA 的 Run/Configuration 中 增加 一 个 Maven 配 置 项 目 ， 工 作 目录 选择 工程 根 目 录 spring-boot-dbup 所 在 的 路 径 ， 在 命令 行 中 输入 指令 clean package， 然 后 将 配置 项 目 保 
存 为 mvn。 或 者 直接 打开 一 个 命令 行 窗口 ， 切 换 到 工程 根 目 录 所 在 路 径 ， 执 行 下 列 Maven 指 令 : 



































mvn clean package 











打包 完成 后 ， 在 命令 行 窗口 中 切换 到 模块 website 的 target 目 录 中 ， 输 入 下 列 指令 可 运行 应 用 : 

















java -jar website-1.0-SNAPSHOT.jar 





本 6” 水 结 








本 章 使 用 Druid 连 接 池 和 Redis 数 据 库 作为 缓存 ， 提 升 了 关系 型 数据 库 的 访问 性 能 ,并且 通过 扩展 全 局 的 JPA 接 口 ， 丰 富 了 资源 库 的 调用 功能 。 












































对 于 大 数据 时 代 的 互联 网 应 用 来 说 ， 要 从 根本 上 提升 数据 库 的 性 能 ， 主 要 还 在 于 数据 库 本 身 的 设计 和 配置 上 ， 例 如 使 用 分 布 式 设计 的 集群 系统 ， 通 过 合理 的 配置 和 组 装 ， 可 以 达到 横向 扩展 的 目的 ， 以 
后 通过 增加 设备 的 方式 ， 可 以 随时 扩充 数据 库 的 容量 和 提高 其 访问 性 能 。 























有 了 完备 的 数据 库 访问 功能 和 漂亮 的 操作 界面 之 后 ， 一 个 应 用 中 更 重要 的 设计 就 是 安全 设计 了 。 下 一 章 将 介绍 使 用 Spring Security 来 为 一 个 应 用 实现 安全 设计 ， 从 而 实现 用 户 认证 和 权限 管理 方面 的 功 
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SS 


第 5 章 Spring Boot 安 全 设计 



































Web 应 用 的 安全 管理 ， 主 要 包括 两 个 方面 的 内 容 : 一 方面 是 用 户 身份 认证 ， 即 用 户 登 录 的 设计 ; 另 一 方面 是 用 户 授权 ， 即 一 个 用 户 在 一 个 应 用 系统 中 能 够 执行 哪些 操作 的 权限 管理 。 权 限 管理 的 设计 一 
般 使 用 角色 来 管理 ， 即 给 一 个 用 户 赋予 哪些 角色 ， 这 个 用 户 就 具有 哪些 权限 。 本 使 用 spring-cloud-security 来 进行 安全 管理 设计 。 下 面 首先 了 解 安 全 设计 的 依赖 配置 管理 。 
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5.1 “依赖 配置 管理 

















为 了 更 方便 地 使 用 spring-cloud-security， 将 使 用 Spring Cloud (关于 Spring Cloud 将 在 后 面 的 章节 中 介绍 ) 的 Maven 依 赖 配置 ， 如 代码 清单 5-1 所 示 。Spring Cloud 有 两 个 版 本 ， 第 一 版 本 的 代号 是 
Angel， 第 二 个 版 本 的 代号 是 Brixton， 这 两 个 版 本 又 包含 各 自 的 子 版 本 ， 将 使 用 Brixton.M5， 因 为 它 包含 了 Spring Boot 1.3.2， 这 和 前 面 章节 使 用 Spring Boot 的 版 本 相同 ， 同 时 Spring Security 默 认 的 版 
本 是 4.0 以 上 。 









































代码 清单 5-1 Maven 依 赖 配置 





<parent> 
<groupId>org.springframework.cloud</groupId> 
<artifactId>spring-cloud-starter-parent</artifactId> 
<version>Brixton.M5</version> 
<relativePath/> 

</parent>……… 

<dependency> 
<groupId>org.springframework.cloud</groupId> 
<artifactId>spring-cloud-starter-security</artifactId> 

</dependency> 

















了 解 依 赖 配置 管理 后 ， 学 习 如 何 配置 安全 策略 。 


5.2 “安全 策略 配置 
































关于 系统 的 安全 管理 及 各 种 设计 ，Spring Security 已 经 大 体 上 都 实现 了 ， 只 需要 进行 一 些 配置 和 引用 ， 就 能 够 正常 使 用 。 如 代码 清单 5-2 所 示 ， 安 全 配置 类 SecurityConfiguration 继 承 了 Spring 
Security 的 WebsecurityConfigurerAdapter。 这 里 可 以 使 用 HttpSecurity 的 一 些 安全 策略 进行 配置 ， 各 项 配置 的 解释 如 下 : 


















































“ loginPage : 设置 一 个 使 用 自 定义 的 登录 页 面 URL。 

“ loginSuccessHandler: 设置 自 定义 的 一 个 登录 成 功 处 理 器 。 

“ permitAll: 是 完全 允许 访问 的 一 些 URL 配 置 ， 并 可 以 使 用 通配符 来 设置 ， 这 里 将 一 些 资源 目录 赋予 可 以 完全 访问 的 权限 ， 由 settings 指 定 的 权限 列表 也 赋予 了 完全 访问 的 权限 。 
“ logout: 设置 使 用 默认 的 登 出 。 

“ logoutSuccessUrl: 设 定 登 出 成 功 的 链接 。 

“ tememberMe: 用 来 记 住 用 户 的 登录 状态 ， 即 用 户 没 有 执行 退出 时 ， 再 次 打开 页 面 将 不 用 登录 。 

“ cstf; 即 跨 站 请 求 伪造 (cross-site request forgery) ， 这 是 一 个 防止 跨 站 请 求 伪造 攻击 的 策略 设置 。 


"accessDeniedPage: 配置 一 个 拒绝 访问 的 提示 链接 。 

















其 中 ，settings 是 引用 了 自 定义 的 配置 参数 。 





代码 清单 5-2 安全 策略 配置 





public class SecurityConfiguration extends WebSecurityConfigurerAdapter { 
@Autowired 
private SecuritySettings settings; 
QOverride 
protected void configure (HttpSecurity http) throws Exception { 
http.formLogin() .loginPage ("/login") .permitAl]l () .successHandler (login 


SuccessHandler ()) 
.and() .authorizeRequests () 
.antMatchers ("/images/**", "/checkcode", "/scripts/**", "/styles/**") .permitAll () 
.antMatchers (settings.getPermitall () .split (",")) .permitAll () 
.anyRequest () .authenticated () 
.and() .csrf () .requireCsrfProtectionMatcher (csrfSecurityRequestMatcher () ) 
and() .sessionManagement () .sessionCreationPolicy (SessionCreationPolicy .NEVER) 
.and() .logout () .logoutSuccessUr] (settings.getLogoutsuccssurl ()) 
and () .exceptionHandling () .accessDeniedPage (settings .getDenied 
Page () ) 


.and() .rememberMe () .tokenValiditySeconds (1209600) .tokenRepository (tokenRepository () ) 7 


http://www.hzcourse.com/resource/readBook?path=/openresources/teach ebook/uncompressed/15925/0EBPS/Text/..http://www.hzcourse.com/resource/readBook?path=/openresources/teac 
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5.2.1 ”权限 管理 规 由 
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代码 清单 5-2 中 引用 的 SecuritySettings 是 自 定义 的 一 个 配置 类 ， 如 代码 清单 5-3 所 示 。 其 中 使 用 注解 @ConfigurationProperties 设 定 配置 参数 的 前 缀 部 分 为 securityconfig， 定 义 的 各 个 配置 参数 的 意 
义 如 下 : 








“ logoutsuccessutl: 用 来 定义 退出 成 功 的 链接 。 
“ permitall: 用 来 定义 允许 访问 的 URL 列 表 。 
“ deniedpage: 用 来 设 定 拒绝 访问 的 信息 提示 链接 。 


“ urlroles: 这 是 一 个 权限 管理 规则 ， 是 链接 地 址 与 角色 权限 的 配置 列表 。 


代码 清单 5-3 ” 自 定义 配置 类 


QConfigurationProperties (prefix="securityconfig") 
public class SecuritySettings { 
private String logoutsuccessurl = "/logout"; 
private String permitall = "/api 
private String deniedpage = "/deny"; 
private String urlroles; 
http://www.hzcourse.com/resource/readBook?path=/openresources/teach ebook/uncompressed/15925/0EBPS/Text/..http://www.hzcourse.com/resource/readBook?path=/openresources/teac 























使 用 自 定义 配置 参数 后 ， 可 以 在 工程 的 配置 文件 application.yml 中 对 安全 管理 进行 集中 配置 ， 如 代码 清单 5-4 所 示 。 

















代码 清单 5-4 ”使 用 自 定义 的 securityconfig 配 置 








Securityconfig: 
logoutsuccssurl: / 
permitall: /rest/**,/bbs** 
deniedpage: /deny 
urlroles: /**/new = manage,admin; 
/**/edit/** = admin; 
/**/delete/** = admin 











其 中 urlroles 配 置 一 个 权限 配置 列表 ， 这 是 我 们 设计 的 一 种 权限 管理 规则 ， 列 表 中 的 每 一 个 配置 项 用 分 号 分 隔 ， 每 一 个 配置 项 的 等 号 左边 是 一 个 可 以 带 上 通配符 的 链接 地 址 ， 等 号 右边 是 一 个 角色 列表 ， 
角色 之 间 用 逗号 分 隔 。 每 一 个 配置 项 表示 包含 等 号 左边 字符 串 的 链接 地 址 ， 能 够 被 等 号 右边 的 角色 访问 。 



























































这 将 要 求 我 们 的 控制 器 设计 链接 地 址 时 ， 必 须 遵循 这 一 权限 管理 规则 ， 这 样 只 要 使 用 一 个 简单 的 配置 列表 ， 就 能 够 覆盖 整个 系统 的 权限 管理 策略 。 设 计 控 制 器 链接 地 址 的 规则 如 下 ， 它 包含 了 系统 增删 
查 改 的 所 有 操作 。 























“ /**/new: 新 建 ; 


et 入 政 ; 


*/**/delete/**: 删除 ; 


* /**/show/**; 查看 ; 


. /##/list: 列表 查询 。 






































使 用 这 种 规则 之 后 ， 再 来 看 看 代码 清单 5-4 中 urlroles 的 权限 配置 ， 这 里 只 需要 简单 的 三 个 配置 项 ， 就 已 经 完成 了 对 一 个 应 用 系统 所 有 权限 的 管理 配置 了 。 其 中 ， 新 建 操作 只 有 manage、admin 两 个 角 
色 有 权限 ， 修 改 操作 和 删除 操作 只 有 admin 这 个 角色 有 权限 ， 至 于 没有 在 权限 管理 列表 中 配置 的 查看 操作 ， 因 为 没有 限定 角色 访问 ， 所 以 它 能 被 所 有 用 户 访问 。 













































































这 种 权限 策略 配置 好 了 之 后 ， 要 让 应 用 系统 中 的 一 个 用 户 具有 哪些 权限 ， 只 要 分 配给 这 个 用 户 一 些 角色 就 可 以 。 


























5.2.2 ”登录 成 功 处 理 器 























登录 成 功 后 ， 如 果 需 要 对 用 户 的 行为 进行 记录 或 者 执行 其 他 操作 ， 可 以 使 用 登录 成 功 处 理 器 。 代 码 清单 5-5 是 一 个 登录 成 功 处 理 器 的 定义 ， 这 里 只 是 简单 地 输出 了 用 户 登录 的 日 志 。 






































代码 清单 5-5 ”登录 成 功 处 理 器 





QOverride 
public void onAuthenticationSuccess (HttpServletRequest request, HttpServletResponse response, Authentication authentication) 
throws IOException,ServletException { 
User userDetails = (User)authentication.getPrincipal (); 
log.info ("登录 用户 user:" + userDetails.getName() + "login"+request.getContextPath()); 
log.info("IP:" + getIpAddress (request)); 
super .onAuthenticationSuccess (request, response, authentication); 





5.2.3 ” 防 攻击 策略 











因为 Spring Security 的 跨 站 请 求 伪造 (cross-site request forgery，CSRF) 即 阻止 跨 站 请 求 伪造 攻击 的 功能 很 完善 ， 所 以 使 用 Spring Security 之 后 ， 对 于 新 建 、 修 改 和 删除 等 操作 ， 必 须 进行 特殊 的 
处 理 ， 才 能 正常 使 用 。 这 要 求 在 所 有 具有 上 面 操作 请 求 的 页 面 上 提供 如 下 代码 片段 ， 因 为 我 们 的 页 面 设计 使 用 了 Thymeleaf 模 板 ， 所 以 只 要 在 layout.hmtl 的 页 头 上 加 入 下 面 两 行 代码 即 可 ，loyou.htm| 是 所 
有 页 面 都 会 用 到 的 一 个 页 面 文件 。 


































































































<meta name="_csrf" th:content="${_csrf.token}"/> 
<meta name="_csrf header" th:content="${ csrf.headerName}"/> 








还 要 在 loyout.html 中 引用 脚本 文件 publicjs， 然 后 在 publicjs 中 增加 一 个 函数 ， 如 代码 清单 5-6 所 示 。 这 样 做 的 意思 是 ， 在 表单 提交 时 放 入 一 个 token， 服 务 端 验证 该 token 是 否 有 效 ， 只 允许 有 效 的 
token 请 求 ， 否 则 拒绝 当前 操作 。 这 样 就 能 够 很 好 地 起 到 防御 CSRF 攻 击 的 目的 。 


代码 清单 5-6 ”阻止 CSRF 攻 击 策略 


$(function () { 
Var token = $ ("meta[name="'_csrf"']") .attr ("content"); 
Var header = $ ("meta[lname='_csrf header']").attr("content"); 


$ (document) .ajaxSend (function (le, xhr, options) { 
xhr.setRequestHeader (header, token); 
1D); 





























如 果 要 对 第 三 方 开放 接口 ， 上 面 的 方法 就 不 适用 了 ， 这 时 只 能 对 特定 的 URL 使 用 排除 CSRF 保 护 的 方法 来 实现 。 代 码 清单 5-7 对 指定 的 URL 排 除 对 其 进行 CSRF 的 保护 。 














代码 清单 5-7 ”排除 CSRF 保 护 策略 


Public class CsrfSecurityRequestMatcher implements RequestMatcher { 
protected Log 1og = LogFactory.getLog (getClass () ) 7 
Private Pattern allowedMethods = Pattern 
.compile("^ (GET|HEAD|TRACE |OPTIONS) $"); 


大大 


y 需要 排除 的 url 列表 


private List<String> execludeUrls; 


QOverride 
public boolean matches (HttpServletRequest request) { 
if (execludeUrls != null && execludeUrls.size() > 0) { 


String servletPath = request.getServletPath (); 
for (String url : execludeUrls) { 
if (servletPath.contains (url)) { 
log.info("++++"+servletPath); 
return false; 


} 
} 
return !allowedMethods.matcher (request .getMethod()) .matches () 7 

















然后 在 配置 类 中 ， 加 入 需要 排除 阻止 CSRF 攻 击 的 链接 列表 ， 如 代码 清单 5-8 所 示 ， 只 要 链接 地 址 中 包含 “/rest” 字 符 串 ， 就 将 对 其 忽略 CSRF 保 护 策略 。 





代码 清单 5-8 ”在 安全 配置 类 加 入 需要 排除 CSRF 保 护 的 列表 





private CsrfSecurityRequestMatcher csrfSecurityRequestMatcher (){ 
CsrfSecurityRequestMatcher csrfSecurityRequestMatcher = new CsrfSecurity 
RequestMatcher (); 
List<String> list = new RrrayList<String> () 7 
list.add("/rest/"); 
csrfSecurityRequestMatcher.setExecludeUrls (list); 
return csrfSecurityRequestMatcher; 


5.2.4” 记 住 登录 状态 





























代码 清单 5-2 中 的 安全 策略 配置 中 有 一 行 配置 : rememberMe () .tokenValiditySeconds (86400) .tokenRepository (tokenRepository () ) ， 它 是 用 来 记 住 用 户 登 录 状态 的 一 个 配置 ， 其 中 
86400 指 定 记 住 的 时 间 秒 数 ， 即 为 1 天 时 间 。 为 了 实现 这 个 功能 ， 需 要 将 一 个 用 户 的 登录 令 牌 等 信息 保存 在 数据 库 中 ， 这 需要 在 配置 类 中 指定 连接 数据 库 的 数据 源 ， 如 代码 清单 5-9 所 示 。 
































代码 清单 5-9 ”指定 保存 登录 用 户 token 的 数据 源 





QAutowired @Qualifier ("dataSource") 
private DataSource dataSource; 
QBean 
public JdbcTokenRepositoryImpl tokenRepository(){ 
JdbcTokenRepositoryImpl jtr = new JdbcTokenRepositoryImpl (); 
jtr.setDataSource (dataSource); 
return jtr; 




















同时 ， 还 应 该 在 数据 库 中 增加 一 个 数据 表 persistent_logins， 这 个 表 结构 的 定义 是 由 Spring Security 提 供 的 ， 使 用 一 个 实体 来 实现 ， 这 样 做 的 目的 只 是 为 了 在 系统 启动 时 能 够 创建 这 个 表 结构 而 已 ， 如 
代码 清单 5-10 所 示 ， 它 用 来 保存 用 户 名 、 令 牌 和 最 后 登录 时 间 等 信息 。 









































代码 清单 5-10” 记 住 用 户 登 录 状态 的 实体 建 模 








Q@Entity 

QTable (name = "persistent logins") 

public class PersistentLogins implements java.io.Serializable{ 
@Id 
Q@Column (name = "series", length = 64, nullable = false) 
private String series; 
@Colum (name = "username", length = 64, nullable = false) 


private String username; 

Q@Column (name = "token", length = 64, nullable = false) 
private String token; 

@Temporal (TemporalType .TIMESTAMP) 

QColumn (name = "last used", nullable = false) 


private Date last used;.…… 


i 


5.3 ”登录 认证 设计 






























































完成 上 面 的 安全 策略 配置 之 后 ， 打 开 受 保护 的 页 面 或 链接 时 ， 就 会 引导 用 户 到 登录 页 面 上 输入 用 户 名 和 密码 验证 用 户 身份 。 如 果 在 安全 配置 中 没有 指定 登录 页 面 URL，Spring Security 就 调用 其 默认 的 
登录 页 面 。 只 是 ，Spring Security 的 登录 页 面 设计 很 简单 ， 不 适合 于 一 般 的 Web 应 用 的 登录 设计 。 除 了 登录 页 面 ，Spring Security 对 于 用 户 身份 验证 同样 也 已 经 实现 了 ， 只 需要 加 以 引用 即 可 。 






































5.3.1 ”用 户 实体 建 模 
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可 以 使 用 第 2 章 的 实例 工程 MySQL 模 块 的 实体 建 模 来 建立 用 户 体系 ， 回 顾 一 下 ， 在 第 2 章 中 建 模 的 实体 中 包含 用 户 、 部 门 和 角色 三 个 对 象 ， 它 们 的 关系 是 ， 一 个 用 户 只 能 属于 一 个 部 门 ， 一 个 用 户 可 以 拥 
有 多 个 角色 ， 这 非常 适合 本 章 的 实例 。 除 了 部 门 和 角色 ， 用 户 实体 的 属性 必须 做 些 调整 ， 以 适合 本 章 实例 的 要 求 ， 如 代码 清单 5-11 所 示 ， 即 增加 了 邮箱 、 性 别 和 密码 等 几 个 属性 ， 其 他 基本 相同 。 

































































代码 清单 5-11 用 户 实体 建 模 








Q@Entity 

QTable (name = "user") 

public class User implements java.io.Serializable{ 
@Id 


@GeneratedValue (strategy = GenerationType.IDENTITY) 
private Long id; 

private String name; 

private String email; 

private Integer sex; 

@DateTimeFormat (pattern = "yyyy-MM-dd HH:mm:ss") 
private Date createdate; 

private String password; 

@ManyToOne 

Q@JoinColumn (name = "did") 

QJsonBackReference 

Private Department department; 

@ManyToMany (cascade = {}, fetch = FetchType .FEAGER) 


QJoinTable (name = "user role", 
joinColumns = {@JoinColumn (name = "user id")}, 
inverseJoinColumns = {@JoinColumn (name = "roles id")}) 


private List<Role> roles; 
http://www.hzcourse.com/resource/readBook?path=/openresources/teach ebook/uncompressed/15925/0EBPS/Text/..http://www.hzcourse.com/resource/readBook?path=/openresources/teac 

































































另外 ， 在 用 户 实体 的 持久 化 方面 ， 也 增加 了 几 个 方法 以 便 能 适用 本 章 实例 的 要 求 ， 如 代码 清单 5-12 所 示 。 其 中 User findByName (String name) 就 是 登录 时 使 用 用 户 名 来 查询 用 户 的 信息 。 
































代码 清单 5-12 用户 实体 持久 化 接口 





Q@Repository 
public interface UserRepository extends JpaRepository<User, Long> { 
@Query ("select 七 from User 七 where 七 .name =?1 and t.email =?2") 
User findByNameAndEmail (String name, String email); 
QQuery("select 七 from User 七 where 七 .name like :name") 
Page<User> findByName (GParam("name") String name, Pageable PageRequest) 
User findByName (String name); 





5.3.2 ”用 户 身份 验证 





























在 安全 配置 类 的 定义 中 ， 使 用 了 如 代码 清单 5-13 所 示 的 配置 ， 用 来 调用 我 们 自 定义 的 用 户 认证 CustomUserDetailsService， 并 且 指 定 了 使 用 密码 的 加 密 算法 为 BCryptPasswordEncoder， 这 是 Spring 
Security 官 方 推荐 的 加 密 算法 ， 比 MD5 算 法 的 安全 性 更 高 。 









































代码 清单 5-13 ”安全 配置 类 引用 





@Autowired 
private CustomUserDetailsService customUserDetailsService; 
QOverride 
protected void configure (AuthenticationManagerBuilder auth) 
throws Exception { 

auth.userDetailsService (customUserDetailsService) .passwordEncoder 

(passwordEncoder () ) 7 
/ remember me 
auth.eraseCredentials (false); 


@Bean 
Public BCryptPasswordEncoder passwordEncoder() { 
return new BCryptPasswordEncoder (); 


} 











了 loadUserByUsername (String userName) ， 并 返回 自 定义 的 Security-User， 通 过 这 个 





如 代码 清单 5-14 所 示 ，CustomUserDetailsService 实 现 了 Spring Security 的 User-DetailsService， 
SecurityUser 来 完成 用 户 的 身份 认证 。 其 中 ，loadUserByUsername 调 用 了 用 户 资源 库 接口 的 findByName 方 法 ， 取 得 登录 用 户 的 详细 信息 。 





























代码 清单 5-14 CustomUserDetailsService 定 义 





Q@Component 
public class CustomUserDetailsService implements UserDetailsService { 
@Autowired 
private UserRepository userRepository; 
QOverride 
public UserDetails loadUserByUsername (String userName) throws UsernameNot 
FoundException { 
User user = userRepository.findByName (userName); 
if (user == null) { 


throw new UsernameNotFoundException("UserName " + userName + " 
not found"); 


return new SecurityUser (user); 
































的 权限 验证 ， 它 的 实现 如 代码 清单 5-15 所 














im 











了 getAuthorities () ， 用 来 取得 为 用 户 分 配 的 角色 列表 ， 用 了 











代码 清单 5-15 SecurityUser 定 义 





public class SecurityUser extends User implements UserDetails 
{ 
QOverride 
public Collection<? extends GrantedAuthority> getAuthorities() { 
Collection<GrantedAuthority> authorities = new ArrayList<Granted 


Authority>(); 
List<Role> roles = this.getRoles (); 
if(roles != null) 


{ 
for (Role role : roles) { 
SimpleGrantedAuthority authority = new SimpleGrantedAuthority 
(role.getName ()); 
authorities.add (authority); 
} 
} 


return authorities; 
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5.3.3 ”登录 界面 设计 











首先 创建 一 个 登录 控制 器 ,编写 如 代码 清单 5-16 所 示 的 代码 ， 这 个 控制 器 很 简单 ， 它 仅仅 是 返回 对 一 个 页 面 的 调用 ， 页 面 的 设计 文件 是 login.html。 





代码 清单 5-16 ”登录 控制 器 





@Controller 
public class LoginController { 
@RequestMapping ("/login") 
public String login(){ 
return "login"; 















































登录 界面 的 设计 在 页 面 文件 login.html 中 完成 ， 代 码 清单 5-17 是 表单 设计 的 部 分 代码 和 一 些 错误 提示 设计 。 表 单 中 设置 了 用 户 、 密 码 和 验证 码 等 输入 框 ， 最 终 使 用 POST 方式 提交 ， 提 交 的 链接 地 址 
是 /loging， 这 将 请 求 Spring Security 的 内 部 方法 。 








代码 清单 5-17 ”登录 界面 表单 设计 








<div th:if="$ {param.error}"> 
<input th:value=" 无 效 的 用 户 或 密码 ! " id="errorMsg" type="hidden"/> 


</div> 
<div th:if="$ {param.logout}"> 
<input th:value=" 你 已 经 退出 ! " id="errorMsg" type="hidden"/> 
</div> 
<div th:if="${#httpServletRequest .remoteUser != null}"> 
<input th:value="${#httpServletRequest.remoteUser}" id="errorMsg" 
type="hidden"/> 
</div> 
<form th:action="@{/login}" id="loginForm" method="post"> 
<div class="loginTit png"></div> 
<ul class="infList"> 
<1i class="grayBox"> 
<label for="username" class="username-icon"></label> 
<input id="username" class="username" name="username" 
type="text" placeholder=" 您 的 用 户 名 "/> 
<div class="close png hide"></div> 
</1i> 
<1i class="grayBox"> 
<label class="pwd-icon" id="pwd"></label> 
<input id="password" name="password" class="pwd" type= 
"password" Placeholder=" 登 录 密 码 "/> 
<div class="close png hide"></div> 
</1i> 
<11 class=""> 
<label class="validateLabel" ></label> 
<input id="checkCode" name="checkCode" class="checkCode" 
type="text" placeholder=" 验 证 码 " /> 
<img onclick="reloadImg ();" 
th:src="@{/images/imagecode}" id="validateImg" alt= 
"验证 码 。 单 击 此 处 更 新 验证 码 。"/> 
<a class="getOother" href="javascript:void(0); 
"reloadImg () ;"” title=" 单 击 此 处 可 以 更 新 验证 码 。"> 更 新 </a> 
</1i> 
</ul> 
<ul class="infList reloadBtn"> 
<1i> 














证 码 "” class="codePic" title= 





onclick= 


<a href="javascript:void(0);" onclick="tologin () ; "> 本 页 面 已 经 失效 。 请 单 击 此 处 重新 登录 。</a> 


</1i> 
</ul> 
<div class="loginBtnBox"> 
<div class="check-box"><input type="hidden" value="0" id= 
"remember-me" name="remember-me" onclick="if (this.checked) {this.value = 1} 
else{this.value=0}" /><span class="toggleCheck no-check" id="repwd"></span> 记 住 我 </div> 
<input type="button" id="loginBtn" onclick="verSubmit ()" 
Value=" 登 录 " class="loginBtn png" /> 
</div> 
</form> 











呐 


完成 的 登录 界面 设计 效果 如 








5-1 所 示 。 
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图 5-1 登录 界面 设计 效果 


5.3.4 “验证 码 验证 


























注意 到 上 面 登录 界面 设计 中 有 一 个 验证 码 功能 ， 这 个 功能 Spring Security 是 没有 的 ， 必 须 由 我 们 来 实现 。 代 码 清单 5-18 是 使 用 验证 码 的 实现 代码 ， 其 中 imagecode 方 法 是 一 个 生成 图 形 验证 码 的 请 
checkcode 方 法 实现 了 对 这 个 图 形 验证 码 的 验证 。 从 验证 码 的 生成 到 验证 的 过 程 中 ， 验 证 码 是 通过 Session 来 保存 的 ， 并 且 设 定 一 个 验证 码 的 最 长 有 效 时 间 为 5 分 钟 。 验 证 码 的 生成 规则 是 从 0~ 9 的 数字 
随机 产生 一 个 4 位 数 ， 并 增加 一 些 干扰 元 素 ， 最 终 组 合成 为 一 个 图 形 输出 。 
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代码 清单 5-18 “验证 码 验证 





@RequestMapping (value = "/images/imagecode") 
public String imagecode (HttpServletRequest request, HttpServletResponse response) 
throws Exception { 
OutputStream os = response.getOutputSstream(); 
Map<String,Object> map = ImageCode.getImageCode (60, 20, os); 
String simpleCaptcha = "simpleCaptcha"; 
request .getSession() .setAttribute (simpleCaptcha, map.get ("strEnsure"). 
toString () .toLowerCase () ) 7 
Tequest.getSession () .setAttribute ("codeTime", new Date () .getTime ()) 7 
tr 提 
ImageIO.write ((BufferedImage) map.get ("image"), "JPEG", os); 
} catch (IOException e) { 
IE 


return nul17 
} 
@RequestMapping (value = "/checkcode") 
@ResponseBody 
public String checkcode (HttpServletRequest request, HttpSession session) 
throws Exception { 
String checkCode = request .getParameter ("checkCode"); 
Object cko = session.getAttribute ("simpleCaptcha") ; // 验证 码 对 象 
if(cko == null1){ 
request .setAttribute ("errorMsg"， "验证 码 已 失效 ， 请 重新 输入 ! ") 7 
return "验证 码 已 失效 ， 请 重新 输入 ! "7 
} 
String captcha = cko.toString () 7 
Date now = new Date(); 
Long codeTime = Long.valueOf (session.getAttribute ("codeTime")+""); 


if(StringUtils.isEmpty(checkCode) || captcha == null || !(checkCode. 
equalsIgnoreCase (captcha) ) ) { 
request .setAttribute ("errorMsg"，" 验 证 码 错误 ! "); 
return "验证 码 错误 1 "7 
jelse if ((now.getTime()-codeTime)/1000/60>5) {// 验证 码 有 效 时 长 为 5 分 钟 
request .setAttribute ("errorMsg"，" 验 证 码 已 失效 ， 请 重新 输入 ! "); 
return "验证 码 已 失效 ， 请 重新 输入 ! "7 


}else { 
session.removeAttribute ("simpleCaptcha"); 
return "1"; 





54 ”权限 管理 设计 






































通过 身份 认证 ， 成 功 登录 系统 后 ， 就 要 开始 检查 用 户 访问 资源 的 权限 ， 如 果 用 户 没有 权限 访问 ， 将 会 阻止 用 户 访问 受 保护 的 资源 ， 并 给 出 错误 提示 信息 。 























5.4.1 权限 管理 配置 





在 安全 配置 类 中 ， 定 义 了 几 个 类 ， 实 现 自 定义 的 权限 检查 判断 及 其 管理 的 功能 ， 如 代码 清单 5-19 所 示 ， 各 个 类 的 意义 如 下 : 
CustomFilterSecurityInterceptor: 权限 管理 过 滤器 。 
“ CustomAccessDecisionManager: 权限 管理 决断 器 。 


* CustomSecurityMetadataSource: 权限 配置 资源 管理 器 。 



























































其 中 ， 过 滤器 在 系统 启动 时 开始 工作 ， 并 同时 导入 资源 管理 器 和 权限 决断 器 ， 对 用 户 访问 的 资源 进行 管理 。 权 限 决断 器 对 用 户 访问 的 资源 与 用 户 拥有 的 角色 权限 进行 对 比 ， 以 此 来 判断 一 个 用 户 是 否 对 
一 个 资源 具有 访问 权限 。 





代码 清单 5-19 安全 配置 类 中 的 权限 管理 设置 


@Bean 

public CustomFilterSecurityInterceptor customFilter() throws Exception{ 
CustomFilterSecurityInterceptor customFilter = new CustomFilterSecurityInterceptor () 7 
customFilter.setSecurityMetadataSource (securityMetadataSource () ) 
customFilter.setAccessDecisionManager (accessDecisionManager ()); 
CustomFilter.setAuthenticationManager (authenticationManager); 
return customFilter; 

} 

@Bean 

public CustomAccessDecisionManager accessDecisionManager() { 
return new CustomAccessDecisionManager (); 

} 

@Bean 

public CustomSecurityMetadataSource securityMetadataSource() { 
return new CustomSecurityMetadataSource (settings.getUrlroles ()); 


i 





5.4.2 ”权限 管理 过 滤器 


























权限 管理 过 滤器 继承 于 Spring Security 的 AbstractSecuritylnterceptor， 实 时 监控 用 户 的 行为 ， 防 止 用 户 访问 未 被 授权 的 资源 ， 如 代码 清单 5-20 所 示 。 


代码 清单 5-20 ”权限 管理 过 滤器 


public class CustomFilterSecurityInterceptor extends AbstractSecurity 
Interceptor implements Filter { 
Private static final Logger logger = Logger.getLogger (CustomFilterSecurityInterceptor.class); 
private FilterIinvocationSecurityMetadataSource securityMetadataSource; 
QOverride 
public void doFilter(ServletRequest request, ServletResponse response, FilterChain 
chain) throws IOException, ServletException { 
FilterInvocation fi = new FilterIinvocation (request, response, chain); 
logger .debug ("===="+fi.getReaquestUr1l() ) 7 
invoke (fi); 


public void invoke (FilterInvocation fi) throws IOException, ServletException { 
InterceptorStatusToken token = super.beforeInvocation (fi); 
try { 
fi.getChain() .doFilter (fi.getRequest (), fi.getResponse()); 
} catch (Exception e) { 
logger .error (e.getMessage ()); 
} finally { 
super.afterInvocation (token, null); 








5.4.3 ”权限 配置 资源 管理 器 


权限 配置 资源 管理 器 实现 了 Spring Security 的 FilterlnvocationSecurityMetadataSource， 它 在 启动 时 导入 代码 清单 5-4 的 权限 配置 列表 。 如 代码 清单 5-21 所 示 ， 权 限 配置 资源 管理 器 为 权限 决断 器 实 
时 提供 支持 ， 判 断 用 户 访问 的 资源 是 否 在 受 保护 的 范围 之 内 。 


























代码 清单 5-21 权限 配置 资源 管理 器 





public class CustomSecurityMetadataSource implements FilterIinvocationSecurityMetadataSource{ 
private static final Logger logger = Logger.getLogger (CustomSecurityMetadataSource .class); 
private Map<String, Collection<ConfigAttribute>> resourceMap = null; 
private PathMatcher PathMatcher = new AntPathMatcher(); 
private String urlroles; 
QOverride 
public Collection<ConfigAttribute> getAllConfigAttributes() { 
return null; 


} 
public CustomSecurityMetadataSource (String urlroles) { 
super () 7 
this.urlroles = urlroles; 
resourceMap = loadResourceMatchAuthority(); 
E 
private Map<String, Collection<ConfigAttribute>> loadResourceMatchAuthority() { 
Map<String, Collection<ConfigAttribute>> map = new HashMap<String, Collection<ConfigAttribute>>(); 
if(urlroles != null && !urlroles.isEmpty()){ 
String[] resouces = urlroles.split(";"); 


for (String resource : resouces){ 
String[] urls = resource.split(" 
String[] roles = urls[1].split 入 
Collection<ConfigAttribute> list = new ArrayList<ConfigAttri 





bute> () 7 
for (String role : roles){ 
ConfigAttribute config = new SecurityConfig (role.trim() ) 
list.add (config); 
} 
// key: url, value: roles 
map.put (urls[0] .trim(), list); 
} 
}else{ 
logger.error ("'securityconfig.urlroles' must be set"); 
logger.info ("Loaded UrlRoles Resources."); 
return map; 
QOverride 


public Collection<ConfigAttribute> getAttributes (Object object) 

throws IllegalArgumentException { 
String url = ((FilterIinvocation) object) .getRequestUr] (); 
logger.debug ("request url is "+ url); 
if (resourceMap null) 

resourceMap loadResourceMatchAuthority(); 
Iterator<String> ite = resourceMap.keySet () .iterator (); 
while (ite.hasNext()) { 

String resURL = ite.next (); 

if (pathMatcher.match(resURL,url)) { 

return resourceMap.get (resURL); 





} 
} 


return resourceMap.get (url); 


http://www.hzcourse.com/resource/readBook?path=/openresources/teach ebook/uncompressed/15925/0EBPS/Text/..http://www.hzcourse.com/resource/readBook?path=/openresources/teac 





5.4.4 ”权限 管理 决断 器 























权限 管理 的 关键 部 分 就 是 决断 器 ， 它 实现 了 Spring Security 的 AccessDecision-Manager， 重 载 了 decide 函 数 ， 使 用 了 自 定 义 的 决断 管理 ， 如 代码 清单 5-22 所 示 。 在 用 户 访问 受 保护 的 资源 时 ， 决 断 器 
判断 用 户 拥有 的 角色 中 是 否 对 该 资源 具有 访问 权限 ， 如 果 没有 权限 将 被 拒绝 访问 ， 并 返回 错误 提示 。 









































代码 清单 5-22 ”权限 管理 决断 器 





public class CustomAccessDecisionManager implements AccessDecisionManager { 
private static final Logger logger = Logger.getLogger (CustomAccessDecisionManager.class); 
QOverride 
public void decide (Authentication authentication, Object object, Collec 
tion<ConfigAttribute> configAttributes)throws AccessDeniedException, InsufficientAuthenticationException { 
if (configAttributes == null) { 
return; 
} 
// config urlroles 
Iterator<ConfigAttribute> iterator = configAttributes.iterator(); 
while (iterator.hasNext()) { 
ConfigAttribute configAttribute = iterator.next (); 
// need role 
String needRole = configAttribute.getAttribute(); 
// user roles 


for (GrantedAuthority ga : authentication.getAuthorities()) { 
if (needRole.equals (ga.getAuthority())) { 
return; 


} 
} 


logger.info ("need role is " + needRole); 


throw new AccessDeniedException ("Cannot Access!"); 


5.5 ”根据 权限 设置 链接 





















































对 于 权限 管理 ， 我 们 可 能 希望 ， 在 一 个 用 户 访问 的 界面 中 ， 不 是 等 到 用 户 单 击 了 一 个 超 链 接 之 后 ， 才 来 判断 用 户 有 没有 这 个 权限 (虽然 这 种 设计 是 必须 的 ) ， 而 是 按照 用 户 拥有 的 权限 来 设置 一 个 用 户 
可 以 访问 的 超 链接 。 这 样 的 设计 对 于 用 户 体验 来 说 ， 显 得 更 加 友好 。 








































































































以 管理 后 台中 用 户 管理 的 例子 来 说 明 如 何 实现 根据 权限 来 设置 链接 。 如 代码 清单 5-23 所 示 ， 在 打开 用 户 管理 主页 的 控制 器 中 ， 读 取 了 当前 用 户 的 权限 配置 ， 然 后 根据 这 个 用 户 的 权限 列表 来 判断 这 个 
户 是 否 拥 有 新 建 、 修 改 和 删除 等 权限 ， 最 后 把 这 些 权 限 通过 变量 传 给 页 面 ， 由 页 面 负责 根据 权限 来 设置 用 户 可 用 的 超 链接 。 其 中 ，newrole、editrole 和 deleterole 分 别 表示 新 建 、 修 改 和 删除 权限 的 判断 
值 。 



























































代码 清单 5-23 ”在 控制 器 中 获取 用 户 权限 





@Value ("${securityconfig.urlroles}") 
private String urlroles; 
@RequestMapping ("/index") 
public String index (ModelMap model, Principal user) throws Exception{ 
Authentication authentication = (Authentication)user; 
List<String> userroles = new ArrayList<>(); 
for (GrantedAuthority ga : authentication.getAuthorities()){ 
userroles.add (ga.getAuthority()); 
} 
boolean newrole=false,editrole=false, deleterole=false; 
if(!StringUtils.isEmpty (urlroles)) { 
String[] resouces = urlroles.split (";"); 
for (String resource : resouces) { 
String[] urls = resource.split ("="); 
if (urls[0] .indexOf ("new") > 0) 
String[] newroles = urls[1 
for (String str : newroles) 
str = str.trim(); 
if(userroles.contains (str)){ 
newrole = true; 
break; 


( 
{ 
].split(™,"); 
{ 


} 


} 
lelse if(urls[0].indexOof ("edit") > 0){ 
String[] editoles = urls[1] .split(","); 
for (String str : editoles){ 
str = str.trim(); 
if (userroles.contains (str)){ 
editrole = true; 
break; 


} 


i 
jelse if(urls[0] .indexOf ("delete") > 0){ 


String[] deleteroles = urls[1] .split(","); 
for (String str : deleteroles){ 
str = str.trim(); 
if (userroles.contains (str)){ 
deleterole = true; 
break; 


} 


model .addAttribute ("newrole", newrole); 

model .addAttribute ("editrole", editrole); 
model .addAttribute ("deleterole", deleterole); 
model .addAttribute ("user", user); 

return "user/index"; 





























在 用 户 管理 的 主页 视图 中 有 一 个 “新 增 ” 超 链接 ， 可 以 通过 控制 器 传递 过 来 的 newrole 值 来 判断 这 个 用 户 对 这 个 链接 有 没有 权限 ， 从 而 决定 这 个 链接 能 不 能 显示 出 来 ， 提 供给 用 户 使 用 ， 代 码 如 下 : 





















































<div class="newBtnBox" th:if="${newrole}"> 
<a id="addUserInf" class="blueBtn-62X30" href="javascript:void(0)"> 新 增 </a> 
</div> 














而 对 于 修改 和 删除 的 权限 ， 因 为 页 面 的 数据 是 从 js 中 生成 的 ， 所 以 可 以 在 生成 用 户 列表 的 程序 段 中 判断 editrole 和 deleterole， 从 而 决定 是 否 提供 这 两 个 功能 的 链接 ， 如 代码 清单 5-24 所 示 。 























代码 清单 5-24 在 js 中 根据 用 户 权限 设置 链接 

















// 填充 分 页 数据 

function fillData (data) { 
Var editrole = $("#editrole") .val (); 
Var deleterole = $("#deleterole") .val (); 
Var $list = $('#tbodyContent') .empty(); 
$.each (data, function(k,v) { 





Var html = ""; 
html += '<tr> '+ 
Ttd>1 + tvid = nall 2 1 $ wid) + "</td>"' + 
'<td>' + (v.name null ? '' : v.name) + '</td>' + 
‘<td>' + (v.email 一 null ? '' : Vv.email) + '</td>' + 
'<td>' + (Vv.createdate == null ? '' : getSmpFormatDateByLong (v.createdate, true)) + '</td>'; 


html += '<td><a class="c-50a73f mlr-6" href="javascript:void(0)" onclick= 
"showDetail(\'' + V.id + '\') "> 查看 </a>'; 
if (editrole == 'true') 
html += '<a class="c-50a73f mlr-6" href="javascript:void(0)" onclick= 
"edit(\'"' + V.id + "\') "> 修改 </a>'; 
if(deleterole == 'true') 
html += '<a class="c-50a73f mlr-6" href="javascript:void(0) 
"del(\''+ V.idt"\') "> 删除 </a>'; 
html +='</td></tr>' ; 
$list.append ($ (html)); 
Ds 


onclick= 























其 中 的 “修改 ”和 “删除 ”权限 的 判断 值 ， 即 代码 中 的 editrole 和 deleterole， 是 在 导入 用 户 管理 的 主页 时 使 用 隐藏 的 输入 框 这 种 方式 传递 进来 的 ， 代 码 如 下 : 



































<input type="hidden" name="editrole" id="editrole" th:value="${editrole}"/> 
<input type="hidden" name="deleterole" id="deleterole" th:value= 
"${deleterole}"/> 





























中 | 
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上 面 这 种 根据 权限 设置 链接 的 设计 ， 只 是 在 一 个 局 部 操作 界面 上 实现 ， 在 实际 应 用 中 ， 可 以 通过 统筹 规划 全 局 视 | 











， 在 全 局 的 角度 中 实现 这 种 设计 。 





5.6 ”运行 与 发 布 








本 章 实例 工程 的 完整 代码 可 以 通过 |DEA 直 接 从 GitHub 中 检 出 : https://github.com/chenfromsz/spring-boot-security.git。 实 例 工程 中 包含 两 个 模块 : mysql 和 web， 其 中 mysq| 模 块 提供 数据 库 管 
理 功 能 ，web 模 块 集成 了 安全 管理 和 一 个 数据 管理 后 台 的 功能 ， 即 用 户 登录 后 可 以 对 用 户 、 部 门 和 角色 等 各 个 对 象 的 数据 进行 管理 。 























5.6.1 系统 初始 化 





























为 了 初始 化 一 个 能 够 登录 系统 的 用 户 ， 我 们 在 工程 模块 mysql 中 编写 了 一 个 JUint 测 试 程序 ， 用 来 生成 一 个 具有 所 属 部 门 和 拥有 角色 的 用 户 ， 如 代码 清单 5-25 所 示 。 测 试 程序 执行 时 ， 将 初始 化 数据 库 ， 
并 生成 一 个 部 门 和 一 个 角色 ， 同 时 创建 一 个 初始 用 户 ， 用 户 名 和 密码 都 为 user， 这 个 用 户 默认 具有 管理 员 的 权限 。 







































































代码 清单 5-25 ”系统 初始 化 测试 程序 





@RunWith (SpringJUnit4ClassRunner.class) 
@ContextConfiguration (classes = {JpaConfiguration.class}) 
public class MysqlTest { 
QAutowired 
UserRepository userRepository; 
@Autowired 
DepartmentRepository departmentRepository; 
QAutowired 
RoleRepository roleRepository; 
@Before 
public void initData(){ 
userRepository.deleteAll (); 
roleRepository.deleteAll (); 
GepartmentRepository.deleteAll (); 
Department department = new Department (); 
department .setName ("开发 部 "); 
departmentRepository.save (department); 
Assert .notNull (department .getId()); 
Role role = new Role(); 
role.setName ("admin"); 
roleRepository.save (role); 
Assert .notNull (role.getId()); 
User user = new User(); 
user.setName ("user"); 
BCryptPasswordEncoder bpe = new BCryptPasswordEncoder (); 
User.setPassword (bpe.encode ("user") ) 
user.setCreatedate (new Date () ) ; 
user.setDepartment (department); 
userRepository.save (user); 
Assert .notNull (user.getId()); 
} 
@Test 
public void insertUserRoles (){ 
User user = userRepository.findByName ("user"); 
Assert .notNull (user); 
List<Role> roles = roleRepository.findAll (); 


Assert .notNull (roles) 7 
user.setRoles (roles) 
UserRepository.save (user); 


} 


























这 样 ， 就 可 以 在 IDEA 的 Edit Configuration 中 增加 一 个 JUint 测 试 配 置 项 目 ， 模 块 选择 mysql， 工 作 目 录 选 择 mysql 模 块 所 在 的 工程 根 目录 ， 测 试 类 选择 上 面 的 测试 程序 ， 并 将 配置 保存 为 MysqlTest。 





然后 在 MySQL 服 务 器 中 创建 一 个 test 数 据 库 ， 并 在 测试 程序 所 在 目录 中 打开 配置 类 JpaConfiguration 的 实现 代码 ， 配 置 数 据 源 中 的 url、username、password， 如 代码 清单 5-26 所 示 。 








代码 清单 5-26 ”测试 程序 的 JpaConfiguration 数 据 源 配置 








QBean 
public DataSource dataSource() { 

DriverManagerDataSource dataSource = new DriverManagerDataSource(); 
dataSource.setDriverClassName ("com.mysql .jdbc.Driver"); 
dataSource.setUrl ("jdbc:mysql:// localhost:3306/test?characterEncoding= 

Wren} 
dataSource.setUsername ("root"); 
dataSource.setPassword("12345678"); 
return dataSource; 





最 后 运行 测试 项 目 MysqlTest， 运 行 成 功 后 生成 一 个 初始 用 户 ， 用 户 名 和 密码 为 user， 并 且 该 用 户 的 所 属 部 门 为 “开发 部 。， 拥 有 一 个 管理 员 角 色 为 admin。 


5.6.2 ”系统 运行 与 发 布 





首先 ， 在 web 模 块 的 配置 文件 application.yml 中 配置 连接 MySQL 服 务 器 的 数据 源 ， 其 他 JPA 和 安全 配置 可 以 保持 不 变 。 





如 果 在 IDEA 中 运行 应 用 ， 可 以 在 IDEA 的 Edit Configuration 中 增加 一 个 Spring Boot 配 置 项 目 ， 模 块 选择 web， 工 作 目录 选择 web 模 块 所 在 的 工程 根 目 录 ， 主 程序 选择 
com.test.web.WebApplication， 并 将 配置 项 目 保存 为 web。 

















然后 运行 配置 项 目 web 即 可 启动 Web 应 用 ， 启 动 成 功 后 ， 在 浏览 器 中 输入 网 址 http://localhost 访 问 应 


























在 出 现 的 登录 界面 中 ， 输 入 上 面 生成 的 用 户 名 和 密码 user， 并 输入 正确 的 验证 码 ， 即 可 登录 系统 。 登 录 系 统 后 ， 可 对 用 户 、 部 门 和 角色 进行 管理 。 






































如 果 要 发 布 应 用 ， 既 可 以 在 IDEA 中 增加 一 个 Maven 配 置 ， 也 可 以 打开 一 个 命令 行 窗口 ， 将 目录 切换 到 工程 的 根 目录 ， 然 后 执行 下 列 指令 来 完成 。 








mvn clean package 





总 使 用 上 面 的 发 布 指令 将 会 自动 调用 MysqlTest 测 试 程序 ， 这 将 删除 数据 库 的 所 有 资料 ， 执 行 初始 化 操作 ， 然 后 创建 一 个 初始 用 户 ， 用 户 名 和 密码 都 为 user， 并 且 具 有 管理 员 的 权限 。 如 果 不 想 自 
动 调用 测试 程序 ， 可 在 上 面 指令 中 加 上 参数 : -D skipTests。 


打包 成 功 后 可 在 命令 行 窗 口中 ， 运 行 下 列 指令 启动 系统 (假如 当前 目录 为 工程 根 目录 ) 。 








java -jar web/target/web-1.0-SNAPSHOT.jar 


S57 WE 




















本 章 使 用 Spring Security， 实 现 了 Web 应 用 系统 的 安全 管理 功能 ， 即 用 户 认 证 和 权限 管理 等 功能 。 使 用 Spring Security 省 略 了 很 多 安全 管理 的 设计 和 实现 的 工作 ， 同 时 引用 Spring Security 的 功能 ,使 
一 些 自 定义 的 设计 ， 又 让 安全 管理 设计 增加 了 很 多 灵活 性 ， 例 如 ， 可 以 设计 出 更 加 漂亮 的 登录 界面 、 更 加 简便 的 权限 管理 措施 和 策略 等 。 
























































Spring Security 安 全 管理 功能 完善 而 且 强大 ， 那 么 对 于 分 布 式 应 用 环境 ， 又 将 怎样 使 用 呢 ? 下 一 章 使 用 Spring Security 结 合 OAuth2 协 议 来 设计 分 布 式 应 用 环境 中 的 单 点 登录 。 
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二 部 分 “分布 式 应 用 开发 

“第 6 章 Spring Boot SSO 

“ 第 7 章 使 用 分 布 式 文件 系统 

“第 8 章 云 应 用 开发 

“ 第 9 章 构建 高 性 能 的 服务 平台 

这 一 部 分 介绍 分 布 式 应 用 系统 的 开发 及 其 怎么 构建 一 个 高 性 能 的 服务 平台 。 

第 6 章 介 绍 在 分 布 应 用 系统 中 怎样 进行 安全 管理 ， 并 使 用 Spring Security 结 合 OAuth2 设 计 一 个 SSO 管 理 系统 。 

第 7 章 介 绍 如 何在 Spring Boot 中 使 用 分 布 式 文件 管理 系统 ， 同 时 使 用 定制 方式 和 富 文本 编辑 器 方式 演示 了 文件 上 传 的 功能 ， 还 介绍 了 怎样 建立 和 管理 本 地 文件 库 。 
第 8 章 使 用 Spring Cloud 云 应 用 开发 工具 集 ， 介 绍 了 配置 管理 、 发 现 服务 和 监控 服务 的 使 用 ， 以 及 如 何 使 用 动态 路 由 和 断路 器 的 功能 ， 创 建 高 可 用 的 微服 务 应 用 。 
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第 9 章 介绍 使 用 Docker 引 擎 和 docker-compose 工 具 来 发 布 应 用 和 管理 服务 ， 以 及 如 何 构建 一 个 高 性 能 的 服务 平台 和 怎样 使 用 Docker 实 施 负 载 均衡 。 


第 6 章 Spring Boot SSO 

































































一 个 企业 级 的 应 用 系统 可 能 存在 很 多 应 用 系统 ， 每 个 应 用 系统 都 需要 设计 安全 管理 ， 即 实现 用 户 的 认证 和 访问 授权 ， 但 是 不 可 能 为 每 一 个 应 用 系统 都 设计 一 套 安 全 管理 ， 这 样 不 但 耗 时 耗 力 ， 而 且 要 做 
重复 的 工作 ， 也 不 适宜 建立 统一 的 用 户 中 心 。 这 就 需要 使 用 单 点 登录 (Single Sign On，SSO) 的 方式 来 建立 一 个 登录 认证 系统 ， 并 且 实 现 对 用 户 的 统一 管理 。 对 于 一 个 开放 平台 来 说 ，SSO 也 能 为 合作 伙 
伴 提供 用 户 的 身份 认证 和 授权 管理 。 











































































































将 使 用 第 5 章 的 安全 设计 ， 再 略 加 以 扩展 来 建立 一 个 SSO 管 理 系统 。 这 里 介绍 的 SSO 管 理 系统 ， 是 在 使 用 Spring Security 安 全 管理 的 基础 上 ， 再 结合 OAuth2 认 证 授权 协议 来 实现 的 ， 它 不 但 适用 于 大 型 
的 分 布 式 管理 系统 ， 也 适用 于 为 第 三 方 提供 统一 的 用 户 管理 和 认证 的 平台 。 






































6.1 模块 化 设计 














本 章 的 实例 工程 由 于 涉及 的 功能 较 多 ， 将 按照 表 6-1， 对 实例 工程 实行 模块 化 管理 。 其 中 ， 每 个 模块 都 是 一 个 独立 的 项 目 ， 数 据 库 管 理 模块 为 其 他 模块 提供 数据 管理 支持 ， 安 全 配置 模块 为 客户 端 提供 安 
全 配置 和 授权 管理 支持 ， 登 录 认 证 模块 提供 单 点 登录 认证 ( 即 SSO) 功能 ， 共 享 资源 模块 为 客户 端 提供 登录 用 户 需要 的 一 些 共 享 资源 ， 两 个 客户 端 应 用 是 使 用 SSO 系 统 的 两 个 实例 。 






























































表 6-1 实例 工程 模块 列表 


项 目 功能 
数据 库 管理 模块 数据 库 管理 
安全 配置 模块 安全 策略 配置 和 权限 管理 
登录 认证 模块 Web 应 用 SSO 登录 认证 (使 用 端口 ;80 ) 
共享 资源 模块 共享 资源 (使 用 端口 : 8083 ) 
客户 端 应 用 1 客户 端 1 (使 用 端口 : 8081 ) 
客户 端 应 用 2 Web 应 用 客户 端 2 (使 用 端口 : 8082 ) 


使 用 模块 化 设计 可 以 提高 代码 的 复 用 性 ， 避 免 重复 开发 ， 从 而 提高 开发 速度 和 工作 效率 。 例 如 ， 实 例 工程 的 数据 库 管理 模块 和 安全 配置 模块 能 够 被 其 他 模块 共用 ， 从 而 减少 了 大 部 分 重复 的 工作 。 



















































































其 中 ,数据 库 管 理 模 块 mysql 与 第 5 章 的 mysql 模 块 的 功能 完全 相同 ， 它 为 其 他 各 个 模块 提供 了 数据 管理 功能 ， 同 样 具 有 部 门 、 用 户 和 角色 三 个 实体 ， 并 且 提 供 了 对 这 三 个 实体 对 象 的 增删 查 改 等 操作 的 
功能 。 








6.2 ”登录 认证 模块 






































如 果 只 是 本 地 的 登录 认证 ， 只 要 使 用 Spring Security 就 足够 了 。 由 于 使 用 SSO 实 现 了 远程 的 登录 认证 功能 ， 所 以 在 登录 认证 系统 中 ， 需 要 增加 OAuth2 协 议 ， 让 它 可 以 支持 第 三 方 应 用 的 认证 和 授权 。 
























































登录 认证 系统 将 建立 一 个 用 户 中 心 ， 对 使 用 SSO 服 务 的 每 一 个 应 用 系统 ， 提 供 统一 的 用 户 管理 。 而 对 于 一 个 用 户 来 说 ， 使 用 任何 一 个 应 用 系统 ， 都 可 以 通过 SSO 的 OAuth2 协 议 进行 认证 和 授权 确认 。 












































6.2.1 使 用 OAuth2 


























使 用 OAuth2， 在 登录 认证 模块 和 安全 配置 模块 中 都 要 在 工程 的 Maven 依 赖 管理 中 增加 OAuth2 的 依赖 配置 ， 如 代码 清单 6-1 所 示 。 


代码 清单 6-1 OAuth2 依 赖 配置 


<dependency> 
<groupId>org.springframework.cloud</groupId> 
<artifactId>spring-cloud-starter-oauth2</artifactId> 
</dependency> 





6.2.2 ”创建 数字 证 书 























在 OAuth2 的 认证 服务 端 中 ， 需 要 一 个 数字 证 书 ， 为 通信 中 的 数字 签名 等 功能 提供 支持 。 这 个 数字 证 书 可 以 使 用 Java 的 keystore 来 生成 。 下 面 介绍 这 个 数字 证 书 的 生成 过 程 ， 在 实例 工程 中 已 经 具有 这 
个 证 书 ， 不 用 重新 生成 。 


























在 Windows 操 作 系统 中 打开 一 个 命令 行 窗口 ， 使 用 下 列 的 指令 可 以 生成 一 个 数字 证 书 : 


























C:\Users\Alan>keytool -genkey -keystore keystore.jks -alias tycoonclient -keyalg RSA 





执行 这 个 指令 的 操作 过 程 如 下 : 





输入 密 钥 库 口令 :再 次 输入 新 口令 :您 的 名 字 与 姓氏 是 什么 ? 


[Unknown] ; localhost 您 的 组 织 单位 名 称 是 什么 ? 
[Unknown] : ”test 您 的 组 织 名 称 是 什么 ? 
[Unknown] : ”test 您 所 在 的 城市 或 区 域名 称 是 什么 ? 
[Unknown] : ”sz 您 所 在 的 省 /市 /自治 区 名 称 是 什么 ? 
[Unknown] : gd 该 单位 的 双 字 母国 家 /地 区 代码 是 什么 ? 
[Unknown]: cn 
CN=1ocalhost，OU=test，O=test，I=sz，ST=gd，C=cn 是 否 正确 ? 
[ 否 ] : y 输 入 <tycoonclient> 的 密 钥 口令 


(如 果 和 密 铀 库 口令 相同 ， 接 回 车 ) : 





在 上 面 操作 的 过 程 中 ， 输 入 的 密码 是 tc123456， 证 书 的 别名 设 定 为 tycoonclient， 证 书 的 文件 保存 为 keystorejks。 





然后 ， 将 生成 的 证 书 文 件 拷贝 到 登录 认证 模块 的 resources 文 件 夹 中 ， 并 在 OAuth2 配 置 中 设 定 其 相应 的 参数 。 


6.2.3 ”认证 服务 端 配置 


登录 认证 模块 实现 了 SSO 认 证 和 授权 服务 的 功能 ， 在 这 里 必须 对 OAuth2 的 认证 和 授权 服务 ， 以 及 对 Spring Security 的 安全 管理 策略 等 进行 一 些 相关 的 设计 和 配置 ， 为 使 用 SSO 的 客户 端 提供 认证 和 授 
权 的 管理 功能 。 


1.0Auth2 服 务 端 配置 

















在 登录 认证 模块 中 ， 编 写 一 个 OAuthConfigurer 配 置 类 程序 ， 如 代码 清单 6-2 所 示 ， 它 继承 了 AuthorizationServerConfigurerAdapter。 其 中 ， 使 用 注解 @EnableAuthoriza-tionServer 来 启用 
OAuth2 的 认证 服务 器 功能 。 在 JwtAccessTokenConverter 方 法 中 使 用 上 面 生成 的 数字 证 书 : keystore.jks， 并 设置 了 密码 和 别名 等 参数 。 的 configure 方 法 中 设 定 OAuth2 的 客户 端 I1D 为 ssoclient， 
密 钥 为 ssosecret， 这 将 在 使 用 SSO 的 客户 端的 配置 中 用 到 。 另 外 ， 注 意 “autoApprove (true) ”这 行 代码 设 定 了 自动 确认 授权 ， 这 样 登录 用 户 登 录 后 ， 不 再 需要 进行 一 次 授权 确认 操作 。 

























































































代码 清单 6-2 ”OAuth2 服 务 端 配置 





@Configuration 
@EnableAuthorizationServer 
public class OAuthConfigurer extends AuthorizationServerConfigurerAdapter { 
@Bean 
public JwtAccessTokenConverter jwtAccessTokenConverter() { 
JwtAccessTokenConverter converter = new JwtAccessTokenConverter (); 
KeyPair keyPair = new KeyStoreKeyFactory (new ClassPathResource( 
"keystore.jks"), "tc123456" .toCharRrray () ) .getKeyPair ("tycoon 
client"); 
Converter .setKeyPair (keyPair); 
return converter; 
} 
QOverride 
public void configure (ClientDetailsServiceConfigurer clients) 
throws Exception { 
clients.inMemory() .withClient ("ssoclient") .secret ("ssosecret") 
.autoApprove (true) 
.authorizedGrantTypes ("authorization code", "refresh token") 
.Scopes ("openid"); 加 


} 
http://www.hzcourse.com/resource/readBook?path=/openresources/teach ebook/uncompressed/15925/0EBPS/Text/... 





2.Spring Security 服 务 端 配置 


















































因为 认证 服务 器 的 Spring Security 安 全 策略 配置 与 客户 端的 安全 策略 配置 不 同 ， 所 以 它 没有 使 用 工程 中 安全 配置 模块 中 的 配置 ， 而 是 单独 使 用 一 个 配置 类 来 实现 ， 如 代码 清单 6-3 所 示 。 这 里 有 点 像 第 5 
章 的 安全 策略 配置 ， 依 然 提 供 了 记 住 用 户 登录 状态 的 功能 ， 这 样 当 用 户 选 择 记 住 登录 状态 登录 后 ， 只 要 用 户 不 执行 退出 ， 在 记 住 登录 状态 的 有 效 期 内 ， 重 新 打开 授权 的 链接 时 就 可 以 不 用 再 次 登录 。 登 录 页 
面 设 定 还 是 使 用 “/login”。 但 是 这 里 没有 针对 角色 的 一 些 权限 管理 配置 ， 这 是 因为 在 登录 认证 模块 中 只 提供 了 登录 认证 功能 ,并 不 提供 其 他 访问 链接 ， 所 以 这 里 不 需要 配置 一 些 链接 的 角色 权限 管理 。 
























































































































































代码 清单 6-3 ”认证 服务 器 的 安全 策略 配置 





@Configuration 
@Order (SecurityProperties.ACCESS OVERRIDE ORDER) 
public class SecurityConfiguration extends WebSecurityConfigurerAdapter { 
@Autowired 
private CustomUserDetailsService customUserDetailsService; 
QAutowired @Qualifier ("dataSource") 
private DataSource dataSource; 
QOverride 
protected void configure (AuthenticationManagerBuilder auth) 
throws Exception { 
auth.userDetailsService (customUserDetailsService) .passwordEncoder (passwordEncoder () ) 
// remember me 
auth.eraseCredentials (false); 
} 
QOverride 
protected void configure (HttpSecurity http) throws Exception { 
http.formLogin() .loginPage ("/login") .permitAll () .successHandler (loginSuccess 
Handler ()) 
.and() .authorizeRequests () 
.antMatchers ("/images/**", "/checkcode", "/scripts/**", "/styles/ 
**") .permitAll () 
.anyRequest () .authenticated () 
.and() .sessionManagement () .sessionCreationPolicy (SessionCrea 
tionPolicy.NEVER) 
.and () .exceptionHandling () .accessDeniedPage ("/deny") 
.and() .rememberMe () .tokenValiditySeconds (86400) .tokenRepository 
(tokenRepository () ) 7 


http://www.hzcourse.com/resource/readBook?path=/openresources/teach ebook/uncompressed/15925/0EBPS/Text/..http://www.hzcourse.com/resource/readBook?path=/openresources/teac 





6.3 ”安全 配置 模块 





























安全 配置 模块 集成 了 SSO 客 户 端 的 安全 策略 配置 和 权限 管理 功能 ， 可 以 供 使 用 SSO 的 客户 端 使 用 。 代 码 清单 6-4 是 客户 端的 安全 策略 配置 ， 其 中 ， 注 解 @EnableO-Auth2Sso 将 应 用 标注 为 一 个 SSO 客 户 
端 ， 重 载 的 configure 方 法 使 用 了 HttpSecurity 来 配置 一 些 安全 管理 策略 。 注 意 这 里 没有 登录 链接 的 配置 ， 因 为 登录 认证 的 功能 已 经 交 给 OAuth2 处 理 了 。 另 外 ，CustomFilterSecuritylnterceptor 设 定 了 使 


家 


自 定义 的 权限 管理 过 滤器 ， 这 个 功能 还 是 与 第 5 章 的 设计 一 样 ， 这 里 不 再 歼 述 。 



























































代码 清单 6-4 ”客户 端 安 全 策略 配置 





@Configuration 

@EnableOAuth2Sso 

QEnableConfigurationProperties (SecuritySettings.class) 

public class SecurityConfiguration extends WebSecurityConfigurerAdapter { 


@Autowired 
private AuthenticationManager authenticationManager; 
@Autowired 
private SecuritySettings settings; 
QOverride 
public void configure (HttpSecurity http) throws Exception { 
http 
.antMatcher ("/**") .authorizeRequests () 
.antMatchers (settings.getPermitall () .split (",")) .permitAll () 
.anyRequest () .authenticated () 
.and() .csrf () .requireCsrfProtectionMatcher (csrfSecurityRequest 
Matcher () ) 
.CsrfTokenRepository (CsrfTokenRepository() ) .and() 
.addFilterAfter (csrfHeaderFilter(), CsrfFilter.class) 
.logout () .logoutUrl ("/logout") .permitAll () 
.logoutSuccessUrl (settings.getLogoutsuccssurl ()) 
.and() 
.exceptionHandling () .accessDeniedPage (settings .getDeniedpage () ) 7 
} 
@Bean 


public CustomFilterSecurityInterceptor customFilter() throws Exception{ 
CustomFilterSecurityInterceptor customFilter = new CustomFilterSecurity 


Interceptor () 7 
customFilter.setSecurityMetadataSource (SecurityMetadataSource () ) 
CustomFilter.setAccessDecisionManager (accessDecisionManager ()); 
customFilter.setAuthenticationManager (authenticationManager); 
return customFilter; 


} 
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} 





6.4 ”SSO 客户 端 














SSO 客 户 端 要 使 用 安全 配置 模块 的 功能 ， 需 要 在 工程 的 Maven 依 赖 管理 中 ， 增 加 一 个 依赖 配置 ， 如 代码 清单 6-5 所 示 。 























代码 清单 6-5 引用 安全 配置 模块 的 依赖 配置 








<dependency> 
<groupId>springboot .demo</groupId> 
<artifactId>security</artifactId> 
<version>$ {project .version}</version> 
</dependency> 


6.4.1 ”客户 端 配 置 
































当 客 户 端 引用 安全 配置 模块 之 后 ， 就 必须 在 配置 文件 application.yml 中 进行 一 些 相关 的 配置 ， 才 能 正常 使 用 。 代 码 清单 6-6 是 一 个 SSO 客 户 端的 配置 ， 它 包含 两 方面 的 内 容 ， 其 中 security 是 OAuth2 的 
配置 ，securityconfig 是 Spring Security 的 配置 。 














在 OAuth2 的 配置 中 ，loginPath 是 一 个 登录 的 链接 地 址 ，clientld 和 clientSecret 是 由 SSO 认 证 服务 器 提供 的 客户 端 1D 和 密 铀 ，accessTokenUri 是 取得 令 牌 的 链接 地 址 ，userAuthorizationUrij 是 用 户 授 
权 确 认 的 链接 地 址 ，keyUri 是 当 客 户 端 被 指定 为 资源 服务 器 时 所 用 的 令 牌 链接 地 址 。 















































Spring Security 的 配置 中 是 设计 的 一 些 自 定义 配置 参数 ， 它 将 被 安全 管理 策略 配置 类 调 





并 











中 logoutsuccssurl 是 一 个 登 出 成 功 的 链接 地 址 ， 其 他 配置 参数 与 第 5 章 的 安全 管理 配置 基本 相同 。 




















代码 清单 6-6 ”SSO 客 户 端 配置 


Security: 
ignored: /favicon.ico,/scripts/**,/styles/**, /images/** 
sessions: ALWAYS 
oauth2: 
sso: 
loginPath: /login 
client: 
clientId: ssoclient 
clientSecret: ssosecret 
accessTokenUri: http://localhost/oauth/token 
userAuthorizationUri: http://localhost/oauth/authorize 
clientAuthenticationScheme: form 


jwt: 
keyUri: http://localhost/oauth/token key 
securityconfig: 

logoutsuccssurl: /tosignout 
permitall: /rest/**,/bb** 
deniedpage: /deny 
urlroles: /**/new/** = admin; 

/**/edit/** = admin,editor; 

/**/delete/** = admin 





6.4.2 ”登录 登 出 设计 











登录 登 出 的 设计 ， 虽 然 在 Spring Security 中 已 经 实现 ， 但 是 对 于 使 用 SSO 的 客户 端 来 说 ， 必 须 进行 一 些 合理 的 调整 ， 否 则 如 果 设 计 不 当 ， 就 有 可 能 出 现 无 法 正常 退出 或 者 登录 失败 的 情况 。 





















































代码 清单 6-7 是 客户 端的 一 个 登录 控制 器 设计 ， 它 使 用 一 个 重 定向 链接 “redirect: /#/” 来 刷新 当前 访问 页 面 ， 从 而 触发 系统 检查 用 户 的 授权 状态 ， 如 果 用 户 未 被 授权 ， 则 引导 用 户 到 登录 认证 服务 器 
中 登录 。 
































代码 清单 6-7 ”客户 端 登录 控制 器 





@RequestMapping ("/login") 
public String login() { 
return "redirect:/#/"; 


i 























代码 清单 6-8 是 客户 端的 一 个 登 出 设计 ， 退 出 时 首先 通过 用 户 确认 ， 然 后 使 用 POST 方 式 执行 表单 logoutform 的 退出 提交 请 求 ， 这 个 请 求 已 由 Spring Security 实 现 ， 执 行 一 些 清除 会 话 和 登录 状态 等 操 
作 ， 并 将 当前 操作 界面 重 定向 到 登 出 成 功 页 面 上 。 
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这 里 需要 注意 的 是 ， 这 时 只 是 退出 当前 客户 端 而 已 ， 并 没有 在 SSO 服 务 端 中 执行 过 退出 请 求 ， 也 就 是 说 ， 在 SSO 认 证 服务 端 中 ， 还 保存 着 用 户 的 登录 状态 。 如 果 这 时 返回 原来 的 客户 端 ， 或 者 访问 
其 他 有 授权 的 客户 端 ， 都 不 会 要 求 用 户 登录 并 能 正常 访问 。 为 了 能 达 真正 的 退出 ， 还 必须 在 SSO 服 务 端 中 再 执行 一 次 退出 请 求 。 这 个 退出 请 求 必须 由 程序 来 处 理 ， 而 不 能 要 求 用户 转 到 SSO 服 务 端 中 再 执行 
一 次 退出 。 















































代码 清单 6-8 ”客户 端 登 出 设计 





<a href="javascript:void(0)" id="logout">[ 退 出 ]</a> 
http://www.hzcourse.com/resource/readBook?path=/openresources/teach ebook/uncompressed/15925/0EBPS/Text/. .http://www.hzcourse.com/resource/readBook?path=/openresources/teach ek 
<form th:action="@{/logout}" method="post" id="logoutform"> 


</form> 
<script type="text/javascript"> 
$(function () { 


$ ("#1logout") .click (function () { 
if (confirm(' 您 确定 退出 吗 ? ')) { 
$ ("#1logoutform") .submit (); 
i 
]) 7 
]) 7 


</script> 






































在 客户 端 配置 中 有 一 个 成 功 退出 的 链接 地 址 ， 当 用 户 在 客户 端 中 成 功 退 出 时 ， 将 被 重 定 向 到 这 个 链接 地 址 。 代 码 清单 6-9 是 这 个 链接 的 页 面 设计 ， 它 只 做 一 件 简单 的 事情 ， 即 在 当前 页 面 中 做 一 个 跳 转 链 
接 ， 转 到 SSO 服 务 端 中 执行 退出 请 求 。 


代码 清单 6-9” 跳 转 到 SSO 服 务 端 中 执行 登 出 





<script> 
function to sso(){ 
location.href = "http://localhost/signout"; 
} 
</script> 
<body onload="to sso()"> 
</body> 








代码 清单 6-10 是 SSO 服 务 端的 登 出 控制 器 设计 ， 只 有 请 求 这 个 链接 ， 才 能 让 用 户 完全 退出 当前 的 登录 状态 。 程 序 中 使 用 request.logout () 来 请 求 Spring Security 执 行 退 出 请 求 ， 然 后 返回 到 SSO 的 登 
录 界 面 ， 以 刷新 当前 的 页 面 状 态 。 








代码 清单 6-10 ”SSO 服 务 端 登 出 控制 器 





@RequestMapping ("/signout") 
public String signout (HttpServletRequest request) throws Exception{ 
request .logout (); 
return "tologin"; 


} 























代码 清单 6-11 是 接收 上 面 的 请 求 后 ， 返 回 的 一 个 页 面 设计 ， 它 同样 也 只 做 一 件 简单 的 事情 ， 即 将 当前 页 面 跳 转 到 用 户 登录 界面 上 。 
































代码 清单 6-11 ” 跳 转 到 登录 界面 





<script> 
function new window(){ 
location.href = "/login"; 
</script> 
<body onload="new window()"> 
</body> 














Ek 


这 样 ， 用 户 不 管 在 哪个 客 
于 用 户 来 说 ， 是 完全 透明 的 。 














山中 执行 退出 ， 通 过 上 面 的 跳 转 ， 最 终 都 将 被 引导 到 SSO 服 务 端的 登录 界面 上 。 通 过 这 些 流程 的 处 理 ， 用 户 的 一 个 退出 请 求 才能 彻底 退出 登录 状态 。 当 然 ， 上 面 这 些 跳 转 对 



























































户 打开 任何 一 个 客户 端的 页 面 进行 登录 ， 登 录 成 功 后 将 被 引导 到 最 初 打开 的 页 面 上 。 如 果 用 户 直接 在 SSO 认 证 服务 端 上 登录 ， 必 须 有 一 个 成 功 登录 后 的 默认 主页 ， 这 个 页 面 可 以 配置 一 些 其 他 客户 端 
的 导航 链接 。 因 为 把 登录 成 功 的 默认 主页 设计 放置 在 客户 端 1 的 主页 上 ， 所 以 如 果 用 户 从 SSO 服 务 器 中 直接 登录 ， 就 可 以 在 SSO 服 务 器 的 主页 上 做 一 个 跳 转 ， 如 代码 清单 6-12 所 示 ， 将 跳 转 到 客户 端 1 的 主页 

































































代码 清单 6-12 ”登录 成 功 的 默认 链接 设计 





<script> 
1-= 
function new window(){ 
location.href = "http://localhost:8081/"; 


} 
0 
</script> 
<!-- onload="new window()"--> 


<body onload="new window()"> 
http://www.hzcourse.com/resource/readBook?path=/openresources/teach ebook/uncompressed/15925/0EBPS/Text/. .http://www.hzcourse.com/resource/readBook?path=/openresources/teach ek 
</body> 





6.5 ”共享 资源 服务 











实例 工程 的 共享 资源 模块 ， 可 以 为 已 经 授权 的 用 户 提供 一 些 共 享 信息 服务 。 代 码 清单 6-13 是 共享 资源 模块 的 主 程序 ， 它 使 用 注解 @EnableResourceServer 来 标注 这 个 应 用 是 一 个 资源 服务 器 。 




















代码 清单 6-13 ”资源 服务 器 主 程序 





@SpringBootApplication 
QEnableResourceServer 
@ComponentScan (basePackages = "com.test") 
public class ResourceApplication { 
public static void main (String[] args) { 
SpringApplication.run (ResourceApplication.class, args); 














or 
IE 





个 应 用 被 标注 为 资源 服务 器 后 ， 在 浏览 器 中 就 不 能 直接 访问 ， 如 果 在 浏览 器 上 打开 这 样 的 客 





看 到 如 图 6-1 所 示 的 提示 信息 。 








加 
wm 
SG 





， 将 5 














This XIL file does not appear to have any style information associated with it. The document tree is shown below. 


v<oauth> 
verror_descript ior> 
Full authentication is required to access this resource 
/error_description> 
Cerror>mauthorized/ error> 





图 6-1 在 浏览 器 中 打开 资源 服务 器 的 情况 


6.5.1 ”提供 共享 资源 接口 


























启用 资源 服务 器 功能 之 后 ， 就 能 够 对 外 提供 资源 信息 服务 。 代 码 清单 6-14 是 一 个 共享 登录 用 户 信息 的 接口 设计 ， 这 是 提供 了 一 个 “/user” 链 接 的 控制 器 ， 程 序 中 通过 Principal 取 得 登录 用 户 的 用 户 名 ， 



















































































然后 通过 用 户 名 在 数据 库 中 查 出 用 户 的 详细 信息 ， 最 后 返回 包含 用 户 信息 的 一 个 Map 对 象 。 


代码 清单 6-14 ”共享 用 户 信息 接口 设计 








QAutowired 

Private UserRepository userRepository; 

@RequestMapping ("/user") 

public Map<String, Object> user (Principal puser) { 
User user = userRepository.findByName (Puser.getName ()); 
Map<String, Object> userinfo = new HashMap<>(); 
userinfo.put ("id", user.getId()); 
userinfo.put ("name", user.getName () ) 7 
userinfo.put ("email", user.getEmail ()); 
userinfo.put ("department",user.getDepartment () .getName () ) 7 
userinfo.put ("createdate", user.getCreatedate()); 
return userinfo; 





6.5.2 ”使 用 共享 资源 



































在 客户 端 中 要 使 用 资源 服务 器 的 共享 信息 ， 可 以 使 用 spring-cloud-zuul 提 供 的 一 个 路 由 服务 来 实现 。 代 码 清单 6-15 是 客户 端 应 用 2 的 主 程 序 ， 它 使 用 注解 @EnableZuulProxy 来 启用 Zuul 路 由 代理 服 












































务 。 


代码 清单 6-15 ”客户 端 应 用 2 的 主 程序 








@SpringBootApplication 
@EnableZuulProxy 
@ComponentScan (basePackages = "com.test") 
public class Web2Application { 
public static void main (String[] args) { 
SpringApplication.run (Web2Application.class, args); 
































在 工程 配置 文件 application.yml 中 使 用 如 代码 清单 6-16 所 示 的 配置 ， 配 置 一 个 路 由 资源 ， 其 中 path 设 定 资源 的 访问 路 径 ，url 指 定 路 由 的 服务 方 。 


代码 清单 6-16 ”使 用 资源 服务 的 路 由 配置 





zuul: 
routes: 
resource: 
path: /resource/** 
url: http://localhost:8083 
stripPrefix: true 
retryable: true 











这 样 就 可 以 在 客户 端 应 用 2 中 使 用 如 下 的 链接 进行 访问 : 

















http://localhost:8082/resource/user 














或 者 通过 程序 使 用 如 下 的 Ajax 方 式 获取 数据 : 











$.get('./resource/user', {ts:new Date () .getTime ()}, function (data) 





6.5.3 ”查询 登录 用 户 的 详细 信息 



































在 单独 使 用 Spring Security 安 全 管理 的 应 用 中 ， 只 要 在 控制 器 中 使 用 Principal， 就 能 取得 用 户 的 完整 信息 ， 或 者 使 用 如 代码 清单 6-17 所 示 的 代码 ， 也 能 很 容易 地 获取 登录 用 户 的 详细 信息 。 但 是 ， 使 用 
SSO 之 后 ， 这 种 方法 就 不 能 适用 了 ， 这 时 如 果 使 用 getDetails () 将 返回 一 个 空 值 ， 而 在 控制 器 中 使 用 Principal 也 只 能 返回 登录 用 户 的 用 户 名 、 用 户 拥有 的 角色 和 登录 令 牌 等 信息 而 已 ， 用 户 的 其 他 信息 如 
性 别 、 邮 箱 等 将 不 能 取得 。 这 是 OAuth2 基 于 安全 的 考虑 而 设计 的 ， 因 为 SSO 涉 及 了 第 三 方 的 应 用 请 求 ， 所 以 它 保护 了 登录 用 户 的 隐私 信息 。 
































































































































代码 清单 6-17 ”查看 登录 用 户 的 详细 信息 











Authentication authentication = SecurityContextHolder.getContext () .getAuthen 
tication(); 
User user = (User)authentication.getDetails(); 





























如 果 需 要 取得 登录 用 户 的 详细 信息 ， 如 性 别 、 邮 箱 、 所 属 的 部 门 等 ， 就 只 能 像 前 面 提 到 的 那样 ， 使 用 资源 服务 器 提供 的 共享 资源 接口 ， 然 后 通过 Zuul 路 由 代理 服务 获取 已 经 登录 的 用 户 详细 信息 。 


















































代码 清单 6-18 是 一 个 使 用 Ajax 获取 登录 用 户 的 详细 信息 的 例子 。 





代码 清单 6-18 ”从 资源 服务 器 中 获取 登录 用 户 的 详细 信息 





function getuserinfo(){ 
$.get('./resource/user', {ts:new Date () .getTime ()},function (data) { 
Var S$list = $('#tbodyContent') .empty(); 
Var html = "" »} 
html += '<tr> '+ 
'<td>'+ (data.id==null?'':data.id) +'</td>' 十 
"<tdq>'+ (data.name=—=null?'':data.name) +'</td>' + 
'<td>'+ (data.email==null?'':data.email) +'</td>' + 
'<td>'+ (data.department==null?'' :data.department) +'</td>' + 
"<td>'+ (data.createdate==null?'': getSmpFormatDateByLong (data. 
createdate, true)) +'</td>'; 
html +='</tr>' ; 
$1list.append ($ (html)); 
Ds 



































最 后 完成 的 用 户 信息 查询 的 效果 图 如 图 6-2 所 示 。 








邮箱 | null | 


日 其 2016-05-0616:50:08 | 














图 6-2 ”获取 用 户 信息 示例 


6.6 ”运行 与 发 布 


本 章 实 例 工程 的 完整 代码 可 以 通过 IDEA 在 GitHub 中 检 出 : https://github.com/chen-fromsz/spring-boot-sso.git。 


检 出 工程 后 ， 在 本 地 的 MySQL 服 务 器 中 创建 一 个 数据 库 test， 并 运行 下 列 查询 指令 设 定 使 用 数据 库 的 用 户 名 和 密码 。 





grant all privileges on test.* to 'root'@'localhost' identified by '12345678'; 





然后 打开 IDEA 的 Edit Configuration 对 话 框 ， 按 下 列 步骤 增加 配置 : 

1) 在 数据 库 管理 模块 中 增加 一 个 JUint 测 试 配置 ， 运 行 MysqlTest 测 试 程序 ， 用 来 生成 默认 的 登录 用 户 ， 最 终生 成 的 用 户 名 和 密码 均 为 user。 
2) 在 登录 认证 模块 增加 一 个 Spring Boot 配 置 ， 用 来 运行 LoginApplication。 

3) 在 共享 资源 模块 增加 一 个 Spring Boot 配 置 ， 用 来 运行 ResourceApplication。 
4) 在 客户 端 应 用 1 模块 增加 一 个 Spring Boot 配 置 ， 用 来 运行 Web1Application。 
5) 在 客户 端 应 用 2 模块 增加 一 个 Spring Boot 配 置 ， 用 来 运行 Web2Application。 
运行 测试 程序 生成 默认 的 登录 用 户 后 ， 可 以 按 下 列 顺序 运行 各 个 应 用 : 

1) 运行 登录 认证 服务 。 

2) 运行 共享 资源 服务 。 

3) 运行 客户 端 应 用 1。 

4) 运行 客户 端 应 用 2。 

各 个 应 用 启动 完成 后 在 浏览 器 中 输入 : http://localhost。 


在 登录 界面 上 使 用 上 述 创建 的 默认 用 户 登录 ， 登 录 成 功 即 进入 客户 应 用 1 的 系统 首页 ， 如 图 6-3 所 示 。 需 要 注意 的 是 ， 在 单机 上 运行 上 面 4 个 应 用 需要 耗费 一 定 的 内 存 。 如 果 在 各 个 应 用 的 配置 文件 中 ， 
合理 配置 |P 地 址 ， 也 可 以 将 4 个 应 用 发 布 在 不 同 的 机 器 上 运行 ， 其 结果 相同 。 


当前 位 置 : 首页 


Web1 系 统 
信众 容 商 一 


Web1 系 统 平台 





如 果 需 要 进行 发 布 打包 ， 可 以 打开 命令 行 窗口 
mvn clean Package 


注意 运行 打包 指令 全 























Web2 系 统 
请 商 寅 让 
Web2 后 台 管 理 


关于 我 们 | 联系 我 们 


图 6-3 SSO 应 用 示例 


， 将 当前 路 径 切 换 到 工程 根 目 录 中 ， 然 后 执行 下 列 Maven 指 令 : 

















6.7 小 结 
本 章 通 过 使 用 Spring Security 的 安全 管理 功能 ， 
企业 级 的 分 布 式 应 用 系统 开发 ， 提 供 了 切实 可 行 的 应 

















系统 的 安全 设计 非常 重要 ， 但 系统 的 访问 性 能 更 为 重 
























































































































































已 经 上 传 的 文件 库 。 


第 7 章 ”使 用 分 布 式 文件 系统 

















几乎 我 们 提供 的 实例 工程 中 ， 最 终 都 使 





了 打包 成 jar 的 方式 进行 发 布 ， 细 心 的 读者 可 能 会 提出 疑问 ， 如 果 上 传 文件 ， 如 上 传 
的 


在 的 机 器 中 。 这 样 把 工程 打包 成 war 的 方式 进行 发 布 ， 也 是 可 以 的 。 但 是 随 着 业务 


更 加 明显 ， 而 且 再 加 上 一 些 负载 均衡 的 配置 和 





基于 上 述 种 种 原 





在 诸多 分 布 式 的 文件 系统 中 ，FastDFS 是 
展 ， 即 可 以 通过 增加 设备 的 方式 实现 动态 扩容 。 





7.1 FastDFS 安 装 


FastDFS 分 为 服务 端 和 客户 端 API 两 部 分 ， 服 务 端 又 分 为 跟踪 器 (Tracker) 和 存储 节点 (Storage) 两 个 角色 。 跟 踪 器 主要 负责 服务 调度 ， 起 着 负载 均衡 的 作 上 
客户 端 API 提 供 了 文件 的 上 传 、 下 载 和 删除 等 操作 方法 。 


同步 等 功能 。 





因 ， 本 章 将 介绍 一 种 分 布 式 文件 系统 ， 


服务 ， 如 果 还 将 上 传 文件 保存 在 Web 














日 益 发 展 ， 可 能 上 传 的 文件 会 累积 得 越 来 越 多 ， 





片 
站 














说 单 台 机 器 


， 应 该 怎样 保存 ， 保 存在 | 
独 一 台 机 器 往往 会 不 


默认 调用 测试 程序 ， 这 将 对 数据 库 进行 初始 化 ， 并 生成 一 个 具有 管理 员 权 限 的 默认 用 户 。 在 上 面 指令 中 增加 参数 “-D skipTests” 可 以 跳 过 测试 。 
































结合 使 用 OAuth2 的 认证 授权 协议 ， 设 计 了 一 个 具有 统一 用 户 管理 中 心 的 SSO 管 理 系统 ， 实 现 了 能 够 为 第 三 方 应 用 提供 登录 认证 和 授权 管理 的 功能 ， 为 
实例 。 同 时 使 用 spring-cloud-zuul 的 路 由 功能 ， 演 示 了 如 何 通 过 SSO 系 统 使 用 安全 的 共享 资源 。 
要 ， 下 一 章 将 介绍 使 用 分 布 式 文件 系统 来 提升 应 用 系统 的 访问 性 能 ， 并 演示 如 何在 分 布 式 环境 中 使 用 图 片上 传 功能 ， 以 及 怎样 在 本 地 中 建立 和 管理 


了 里 ? 传统 的 做 法 一 般 都 保存 在 Web 服 务 器 所 











重负 。 对 于 大 型 的 分 布 式 系统 来 说 ， 这 种 情况 








容量 和 性 能 | 

















肛 务 所 在 的 机 器 中 ， 会 显得 越 来 越 不 合理 ， 更 不 | 





























来 存储 和 管理 所 有 应 





比较 优秀 的 分 布 式 文件 系统 。FastDFS 是 一 个 完全 开源 的 分 布 式 文件 系统 ， 使 有 





图 | 








典型 的 FastDFS 服 务 器 的 网 络 拓扑 结构 如 


的 上 传 文件 。 








的 问题 。 




















比较 简单 方便 ,而 











性 能 也 很 优秀 


























7-1 所 示 ， 客 户 端 连接 跟踪 器 服务 器 集群 ， 跟 踪 器 管理 存储 节点 集群 ， 为 客户 端 提供 可 | 


， 存 储 容量 和 访问 性 能 可 按 需求 进行 线性 横向 














。 存 储 节点 主要 负责 文件 的 存储 、 读 取 和 











Tracker cluster 


Trackerl Tracker2 TrackerN 


Storage cluster 


Volumel Volume2 VolumeN 


Storage2 Storage2 


StorageN... S i StorageN... 





图 7-1 FastDFS 服 务 器 网 络 拓扑 


FastDFS 支 持 动态 扩展 ， 当 资源 快要 耗 尽 时 ， 可 以 通过 增加 新 卷 (或 新 组 ) 的 方法 ， 增 加 更 多 的 存储 节点 。 














存储 节点 的 文件 使 用 了 分 卷 (或 分 组 ) 的 组 织 方式 ， 所 以 一 个 文件 的 标识 由 卷 名 (或 组 名 ) 、 路 径 和 文件 名 等 部 分 组 成 。 























为 了 演示 使 用 FastFDS， 使 用 虚拟 机 安装 了 三 个 Linux 系 统 。 表 7-1 列 出 了 三 个 服务 器 的 I|P 地 址 、 安 装 的 操作 系统 和 各 自 的 








车 























表 7-1 FastFDS 服 务 器 列表 


F RE 
192.168.1.214 Tracker Server 
192.168.1.215 Storage Server 
192.168.1.216 Storage Server 


下 面 将 按照 步骤 说 明 安 装 的 过 程 ， 由 于 使 用 Nginx 提 供 文件 的 浏览 访问 功能 ， 同 时 也 需要 安装 Nginx 服 务 ， 对 于 文件 的 组 织 方式 使 用 了 分 组 的 方法 ， 并 建立 了 一 个 分 组 : group1。 








7.1.1 下 载 安装 包 


登录 Tracker Server， 使 用 下 列 指令 切换 到 opt 目 录 。 








#cd /opt 











然后 使 用 wget 指 令 下 载 下 列 各 个 安装 包 ， 最 后 将 下 载 的 文件 拷贝 到 其 他 两 台 服务 器 的 相同 目录 中 ( 注 : 检 出 实例 工程 后 ， 在 doc 目 录 中 包含 下 列 安装 包 ) 。 











1. 下 载 FastDFS 5.01 





#wget http://jaist.dl.sourceforge.net/project/fastdfs/FastDFS%20Server%20 
Source%®20Code/FastDFS%20Server®%20with%20PHP%20Extension%20Source%20Code%20 
V5.01/FastDFS v5.01.tar.gz 





2. 下 载 nginx 1.7.0 





#wget http://nginx.org/download/nginx-1.7.0.tar.gz 





3. 下 载 fastdfs-nginx-module_v1.16 





#wget http://jaist.dl.sourceforge.net/project/fastdfs/FastDFS%20Nginx%20 
Module%20Source%20Code/fastdfs-nginx-module v1.16.tar.gz 





7.1.2 ”安装 服务 














三 台 服 务 器 上 都 要 安装 FastDFS 和 Nginx， 其 中 FastFDS 使 用 了 默认 的 安装 配置 ，Nginx 使 用 了 自 定义 的 安装 配置 。 























要 执行 安装 指令 ， 系 统 中 必须 具有 编译 环境 ， 如 果 系统 还 没有 编译 环境 ， 可 以 使 用 下 列 指令 增加 编译 环境 。 





#yum -y install gcc gcc+ gcc-c++ openssl openssl-devel pcre pcre-deve 











1. 创 建 系统 用 户 











#useradd fastdfs -M -s /sbin/nologin 
#useradd nginx -M -s /sbin/nologin 





2. 安 装 FastFDS 





#tar xf FastDFS v5.01.tar.gz 
#cd FastDFS 

#./make.sh 

#./make.sh install 





3. 安 装 Nginx 





#cd http://www.hzcourse.com/resource/readBook?path=/openresources/teach ebook/uncompressed/15925/OEBPS/Text/.. 
#tar xf fastdfs-nginx-module v1.16.tar.gz 

#tar xf nginx-1.7.0.tar.gz 

#cd nginx-1.7.0 

#./configure --user=nginx --group=nginx --prefix=/usr/local/nginx --add-module= 


http://www.hzcourse.com/resource/readBook?path=/openresources/teach ebook/uncompressed/15925/OEBPS/Text/../fastdfs-nginx-module/src 
#make 


#make install 





:+t 总 在 Tracker Server 上 安装 Nginx， 不 需要 --add-module=http://www.hzcourse.com/resource/readBook?path=/openresources/teach_ebook/uncompressed/15925/OEBPS/Text/../fastdfs-nginx-module/stc 这 
个 配置 项 ， 而 两 个 Storage Server 的 安装 必须 加 上 这 个 配置 项 。 


7.1.3 Tracker Server 配 置 





1. 创 建 数据 及 日 志 存放 目录 

















#mkdir -P /data/fastdfs/tracker 





2. 修 改 tracker.conf 配 置 





#vi /etc/fdfs/tracker.conf 





更 改 下 列 两 行 配置 : 





base path=/data/fastdfs/tracker 
group_name=groupl 





3. 修 改 nginx.conf 配 置 





#vi /usr/local/nginx/conf/nginx.conf 





修改 完成 后 如 代码 清单 7-1 所 示 ， 这 是 Tracker Server 的 一 个 负载 均衡 配置 (代码 内 容 可 以 从 工程 的 doc 目 录 nginx.conf-tracker 文 件 中 复制 进来 ) 。 注 意 这 里 的 Tracker Server 开 放 访 问 端口 为 84 ( 非 
必须 ， 只 因为 80 端 口 已 经 作为 其 他 用 途 ) 。 











代码 清单 7-1 Tracker Server 的 Nginx 配 置 





user nginx nginx; 

worker processes 4; 

pid /usr/local/nginx/nginx.pid; 

worker rlimit nofile 51200; 

events 

{ 

use epoll; 

worker connections 20480; 

} 

http 

{ 
include mime.types; 
default type application/octet-stream; 


log format main '$remote addr - $remote User [$time local] "$request"' 
'$status $body bytes sent "$http referer"™"' 
'"$http user agent" "“$http x forwarded for" "$request time 
access log /usr/local/nginx/logs/access.10g main; 
upstream server groupl{ 
server 192.168.1.215; 
server 192.168.1.216; 


ms 


} 
server { 
listen 84; 
server name 192.168.1.214; 
location /groupl { 
include proxy.conf; 
proxy_pass http://server groupl; 





4. 配 置 Tracker Server 启 动 程序 




















使 用 如 下 指令 配置 Tracker Server 的 启动 程序 ， 并 将 其 设置 为 随 系 统 启动 自动 启动 。 








#cp /opt/FastDFS/init.d/fdfs _ trackerd /etc/init.d/ 
#chkconfig -~-add fdfs trackerd 
#chkconfig fdfs trackerd on 





5. 配 置 Nginx 的 启动 程序 








使 用 下 面 指令 创建 一 个 启动 文件 : 











#vi /etc/init.d/nginx 





然后 编辑 (可 以 复制 实例 工程 中 doc 目 录 的 nginx 文 件 内 容 ) 如 代码 清单 7-2 所 示 的 内 容 。 


代码 清单 7-2 Nginx 启 动 程序 





#!/bin/bash 
# nginx Startup script for the Nginx HTTP Server 
# it is v.0.0.2 version. 
# chkconfig: - 85 15 
# description: Nginx is a high-performance web and proxy server. 
# It has a lot of features, but it's not for everyone. 
# processname: nginx 
# pidfile: /var/run/nginx.pid 
# config: /usr/local/nginx/conf/nginx.conf 
nginxd=/usr/local/nginx/sbin/nginx 
nginx config=/usr/local/nginx/conf/nginx.conf 
nginx pid=/var/run/nginx.pid 
RETVAL=0 
prog="nginx" 
Source function library. 
. /etc/rc.d/init.d/functions 
# Source networking configuration. 
. /etc/sysconfig/network 
# Check that networking is up. 
[ ${NETWORKING} = "no" ] && exit 0 
[ 


-x Snginxd ] || exit 0 
# Start nginx daemons functions. 
start() { 


if [ -~e $nginx pid ] ;then 
echo "nginx already runninghttp://www.hzcourse.com/resource/readBook?path=/openresources/teach ebook/uncompressed/15925/OEBPSVText/. .http://www.hzcourse.com/resource/readBc 
exit 1 
£1i 
echo -n $"Starting $prog: " 
daemon $nginxd -c ${nginx config} 
RETVAI=$? 
echo 
[ $RETVAL = 0 ] && touch /var/lock/subsys/nginx 
return $RETVAL 
} 
# Stop nginx daemons functions. 
stop() { 
echo -n $"Stopping $prog: 
killproc $nginxd 
RETVAL=$? 
echo 
[ $RETVAL = 0 ] && rm -f /var/lock/subsys/nginx /var/run/nginx.pid 


} 
# reload nginx service functions. 
reload() { 
echo -n $"Reloading $prog: 
#kill -HUP ‘cat ${nginx pid}. 
killproc $nginxd -HUP 
RETVAI=$? 
echo 


} 
# See how we were called. 
case "$1" in 


start) 
start 
stop) 
stop 
了 
reload) 
reload 
了 
restart) 
stop 
start 
?7 
status) 
status SProg 
RETVAL=$? 
了 
echo $"Usage: $prog {start|stopl|restart|reload|status|help}" 
exit 1 
esac 


exit $RETVAL 





























将 上 面 文件 保存 后 ， 使 用 下 列 指令 ， 修 改 为 任何 人 可 执行 ， 并 将 其 设 定 为 随 系统 启动 自动 启动 : 





#chmod 755 /etc/init.d/nginx 
#chkconfig --add nginx 
#chkconfig nginx on 





7.1.4 _ Storage Server 配 置 
两 台 Storage Server 都 要 进行 下 列 相关 的 配置 。 


1. 创 建 数据 及 日 志保 存 目 录 








#mkdir -p /data/fastdfs/storage/data 





2. 修 改 storage.conf 配 置 





# vi /etc/fdfs/storage.conf 








修改 下 列 配 置 项 ， 其 他 保持 默认 设置 : 





group_name=groupl 

base path=/data/fastdfs 

store path0=/data/fastdfs/storage 
tracker server=192.168.1.214:22122 
run by group=fastdfs 

run by user=fastdfs 

file distribute path mode=1 
rotate error log=true 





3. 修 改 mod _fastdfs.conf 配 置 





#cp /opt/fastdfs-nginx-module/src/mod fastdfs.conf /etc/fdfs/ 
#vi /etc/fdfs/mod fastdfs.conf 





修改 下 列 各 项 配置 : 





connect timeout=30 

tracker server=192.168.1.214:22122 
group_name=groupl 

url have group name = true 

store path count=1 

store path0=/data/fastdfs/storage 





4. 修 改 nginx.conf 配 置 
Storage Server 的 Nginx 配 置 如 代码 清单 7-3 所 示 ， 监 听 80 端 口 ， 并 使 用 fastdfs-nginx-module 模 块 代码 内 容 保存 在 工程 的 doc 目 录 nginx.conf-storage 文 件 中 ) 。 


代码 清单 7-3 Storage Server 的 Nginx 配 置 





user nginx nginx; 
worker processes 4; 
pid /usr/local/nginx/logs/nginx.pid; 
worker rlimit nofile 1024; 
events { 
use epoll; 
worker connections 1024; 


} 
http { 
include mime.types; 
server names hash bucket size 128; 
client header buffer size 32k; 
large client header buffers 4 32k; 
client max body size 20m; 
limit rate 1024k; 
default type application/octet-stream; 
log format main '$remote addr - $remote user [$time local] "$request" ' 
'$status $body bytes sent "$http referer™" ' 
'"$http user agent" "$http x forwarded for"'; 
access_ log /usr/local/nginx/logs/access.10g main; 
server { 
listen 80; 
server name localhost; 
location /groupl/MOO{ 
root /data/fastdfs/storage/data; 
ngx fastdfs module; 





使 用 下 列 指令 创建 一 个 M00 软 连接 ， 让 配置 中 的 M00 同 样 指向 data 目 录 。 





#1ln -s /data/fastdfs/storage/data /data/fastdfs/storage/data/M00 





5. 配 置 Storage Server 的 启动 程序 





#cp /opt/FastDFS/init.d/fdfs_storaged /etc/init.d/ 
#chkconfig -~-add fdfs_storaged 
#chkconfig fdfs_storaged on 





6. 配 置 Nginx 的 启动 程序 


Nginx 的 启动 程序 配置 与 Tracker Server 的 配置 相同 。 如 果 不 使 用 自 定义 的 启动 程序 ， 也 可 以 使 用 下 列 指令 启动 Nginx。 





#/usr/local/nginx/sbin/nginx 





7.1.5 ”启动 服务 


1. 启 动 Tracker Server 





#service fdfs trackerd start 
#service nginx start 





2. 启 动 Storage Server 





#service fdfs_storaged start 
#service nginx start 














启动 后 ， 可 以 使 用 下 列 指令 来 查看 各 个 服务 的 进程 。 








#ps -eflgrep fdfs 
#ps-ef|lgrep nginx 





如 果 能 查看 到 服务 进程 ， 一 般 就 说 明 已 经 启动 成 功 。 


7.1.6 “客户 端 测试 


1. 在 Tracker Server 中 配置 一 个 客户 端 





#vi /etc/fdfs/client.conf 





修改 下 列 配 置 项 : 





base path=/data/fastdfs 
tracker server=192.168.10.214:22122 





2. 查 看 服务 的 运行 情况 


在 Tracker Server 使 用 下 列 指令 可 以 查看 服务 的 运行 情况 : 





#fdfs monitor /etc/fdfs/client.conf 





3. 测 试 文件 上 传 











如 果 在 当前 路 径 (例如 /opt) 中 存在 一 个 图 片 文件 : 01.jpg， 即 可 使 用 下 列 指令 来 测试 上 传 文件 : 

















#fdfs_ upload file /etc/fdfs/client.conf 01.jpg 





上 传 成 功 后 将 返回 已 经 保存 的 文件 标识 ， 它 包含 组 名 、 路 径 和 文件 名 ， 如 下 所 示 : 





groupl/MO0/00/00/wKgB2FAH892ACl1CqAAA2FfBeCgg517 .jpg 





4. 使 用 浏览 器 访问 文件 
































使 用 上 面 配 置 的 Tracker Server 的 Web 服 务 端口 ， 就 可 以 使 用 下 面 完整 的 URL 访 问 上 面 上 传 的 文件 : 


























http://192.168.1.214:84/groupl/MO0/00/00/wKgB2FdH892Acl1CqAAA2FfBeCgg517 .jpg 





@t 意 上 面 这 个 链接 只 是 本 地 局 域 网 的 地 址 ， 如 果 要 在 互联 网 中 使 用 ， 必 须 使 用 外 网 IP 或 者 域名 。 


现在 ， 就 可 以 在 安装 的 两 台 Storage Server 服 务 器 中 其 中 一 台 的 /data 目 录 中 找到 已 经 保存 的 文件 。 




















上 面 测试 成 功 ， 表 明 FastFDS 安 装 成 功 ， 并 且 已 经 正常 运行 ， 接 着 介绍 如 何在 应 用 系统 中 使 用 分 布 式 文件 系统 。 




















上 面 安装 方法 参考 于 http://itindex.net/detail/49559-fastdfs-nginx-%E9%87%8F%E-7%BA%A7。 


7.2 ”FastFDS 客 户 端 


FastDFS 有 Java 的 客户 端 API， 可 以 实现 文件 的 上 传 、 下 载 和 删除 等 操作 。 在 实例 中 ， 将 使 用 一 个 更 加 简单 的 由 第 三 方 提供 的 开源 FastFDS_Client 组 件 ， 更 加 轻 量 地 使 用 FastFDS 分 布 式 文 件 系统 的 功 
能 。FastFDS_ Client 是 由 tobato 提 供 的 专门 为 Spring Boot 应 用 编写 的 FastFDS 客 户 端 应 用 。 需 要 了 解 更 多 有 关 FastFDS Client 的 细节 ， 可 以 从 下 列 URL 中 查看 或 下 载 它 的 源 代 码 。 



































https://github.com/tobato/FastDFS Client.git 





本 章 实例 工程 由 以 下 两 个 模块 组 成 : 


数据 库 管 理 模块 : neo4j; 











Web 应 用 模块 : webapp。 






































其 中 ， 数 据 库 管理 模块 使 用 Neo4 数 据 库 提供 数据 存 取 的 功能 ，Web 应 用 模块 提供 文件 的 上 传 和 管理 等 操作 。 


7.2.1 客户 端 配置 








首先 ， 在 实例 工程 的 Web 应 用 模块 中 的 Maven 依 赖 管理 中 引用 FastFDS_Client 的 依赖 配置 ， 如 代码 清单 7-4 所 示 。 在 工程 的 主 程序 中 增加 一 个 注解 : @Import (FdfsClientConfig.class) ， 以 导入 
FastFDS_Client 的 配置 。 














代码 清单 7-4 FastFDS_Client 依 赖 





<dependency> 
<groupId>com.github.tobato</groupId> 
<artifactId>fastdfs-client</artifactId> 
<version>1.25.1-RELEASE</version> 
</dependency> 











然后 ， 在 Web 应 用 模块 的 工程 配置 文件 application.yml 中 增加 如 代码 清单 7-5 所 示 的 配置 。 其 中 ，trackerList 是 配置 Tracker Server 的 列表 ， 因 为 只 安装 了 一 个 Tracker Server， 所 以 只 要 配置 一 个 即 














可 。 


代码 清单 7-5 ”FastFDS_Client 配 置 





fdfs: 
soTimeout: 1501 
connectTimeout: 601 
thumbImage: 
width: 150 
height: 150 
trackerList: 
- 192.168.1.214:22122 
# = 192.158.1.21522122 
spring.jmx.enabled: false 





7.2.2 ”客户 端 服务 类 



































为 了 能 FastFDS_Client， 需 要 编写 一 个 调用 FastFDS_Client 的 服务 类 Fastefs-Client， 如 代码 清单 7-6 所 示 。 其 中 文件 上 传 时 调用 了 FastFDS_Client 的 uploadFile， 文 件 删除 时 调用 了 
FastFDS_Client 的 deleteFile。 


























代码 清单 7-6 使 用 FastFDS 上 传 和 删除 文件 





@Service 
public class FastefsClient { 
@Autowired 
protected FastFileStorageClient storageClient; 
public String uploFile (MultipartFile file){ 
String fileType = FilenameUtils.getExtension (file.getOriginalFilename 
() ) .toLowerCase (); 
StorePath path = null; 
try { 
path = storageClient .uploadFile (file.getIinputStream(), file.get 
Size(), fileType, null); 
}catch (IOException e){ 
e.printstackTrace (); 


} 
if(path != null) 
return path.getFullPath (); 
else 
return null; 
} 
public void deleteFile(String fullPath){ 
storageClient .deleteFile (fullPath); 





7.3 ”使 用 定制 方式 上 传 图 片 

















所 谓 定制 方式 ， 就 是 设计 一 个 图 片 选 择 框 ， 可 以 使 用 调整 大 小 和 选择 取 图 范围 等 手段 设 定 上 传 的 图 片 文件 。 









































7.3.1 实体 建 模 























性 用 来 保存 单个 图 片 的 





















































为 了 演示 文件 上 传 ， 使 用 Neo4j 数 据 库 创建 一 个 商品 节点 实体 ， 如 代码 清单 7-7 所 示 。 程 序 中 省 略 了 Getter 和 Setter 方 法 ， 这 些 方法 可 以 用 IDEA 编 辑 器 自动 生成 ， 其 中 picture 属 
链接 地 址 ，contents 属 性 用 来 保存 在 富 文本 编辑 器 中 编辑 的 内 容 ， 其 他 属性 如 名 称 、 简 要 说 明 、 定 价 等 结合 起 来 主要 体现 一 个 商品 的 基本 信息 。 


















































代码 清单 7-7 ”商品 节点 实体 建 模 





@NodeEntity 

public class Goods { 
@GraphId 
private Long id; 
private String name; 
Private String brief; 
private String picture; 
private String price; 
Private String contents; 
DateLong 
QDateTimeFormat (Pattern = "yyyy-MM-dd HH:mm:ss") 
private Date create; 


} 





7.3.2 上传 图 片 





1. 上 传 | 


网 


片 对 话 框 设 计 






































在 编辑 商品 的 过 程 中 上 传 图 片 时 ， 将 打开 一 个 上 传 图 片 对 话 框 ， 对 话 框 使 用 JavaScript 设 计 ， 如 代码 清单 7-8 所 示 。 在 对 话 框 中 设计 了 三 个 按钮 ， 分 别 是 确定 、 删 除 和 取消 ， 其 中 确定 按钮 将 调 





















































sureChoose 方 法 对 图 片 进 行 裁剪 ， 然 后 将 上 传 图 片 的 链接 地 址 导入 编辑 商品 的 页 面 ， 由 商品 编辑 的 页 面 保存 。 “/pic/upload” 是 连接 控制 器 的 URL， 使 用 这 个 链接 将 由 控制 器 返回 对 话 框 的 上 传 图 片 页 面 


设计 “uploa-pichtml”。 























代码 清单 7-8 上传 图 片 对 话 框 设 计 








function picUp() { 
Var picWidth = 720, picHeight = 400, callback = setImgUrl; 
var isSubmit = false; 


rt = pic.dialog.show({ 
src: "/pic/upload", 





name: " uploadPic iframe", 
title: "上 传 图 片 "， 
width: 750, 
height: 550, 
titleLineType: 'g-topbg', 
btn: 

no_styl 'white', 


del style: 'orange', 


yes_before close: function (win) { 


if (!issubmit) { 
isSubmit = true; 


win.sureChoose (function 


if (data) { 
callback (data); 
rt.hide(); 

} else { 


(data) { 


isSubmit = false; 


} 
有 
E 
return false; 


}, 


del before close: function (win) { 
win.delChoose (function (data) { 


if (data) { 
delImaConfirm(data) 
} 
Ds 
} 
}, 
load: function (win) { 
win.page.upload.init (picWigdth, 


picHeight); 








2. 上 传 图 片 页 面 设计 














代码 清单 7-9 是 设计 上 传 图 











片 页 面 的 部 分 HTML 代 码 ， 其 中 通过 一 个 类 型 为 file 的 输入 文本 框 ， 从 本 地 中 选择 需要 上 传 的 





出 








片 文件 ， 然 后 将 | 








框 , 这 样 ， 不 但 可 以 调整 上 传 图 片 的 宽度 和 高 度 ， 还 














代码 清单 7-9 ”上 传 图 片 页 面 设计 











[ 





可 以 在 图 片 中 选择 特定 的 区 域 进行 裁剪 。 























出 


片 展示 在 编辑 界 





上 。 在 编辑 界 


四 
宣 









































于 == 个 








片 选择 








<div class="img-view"> 


<div class="up-tit"> 下 图 为 您 的 图 片 展示 ， 请 注意 是 否 清晰 。</div> 


<div class="upload-box"> 
单 击 上 传 
<input id="pictureFile" 
</div> 
<div class="view-box"> 


name="pictureFile" type="file" class="file" onchange="uploadPic submit (this)"/> 


<div class="view" id="view"><img/></div> 


<input type="hidden" 

<input type="hidden" 

<input type="hidden" 

<input type="hidden" 
</div> 










value="" i 








Mpl"/><!1= 一 左上 坐标 一 -> 
p2"/><1-- 右上 坐标 --> 
P3n/><!-- 右 下 坐标 --> 
"p4"/><!-- 左下 坐标 --> 


<div class="file-type"> 支 持 类 型 : jpg、jpeg、png。<span class="error"> 格 式 不 正确 </span></div> 


<div class="reupload"> 
<div class="1"> 
<div clas, 





="newUpDiv"><p> 选 择 文件 </p> 


<input id="changerFile" class="g-btn g-btn-white"name="pictureFile" 
type="file" onchange="uploadPic submit (this)"/> 

















</div> 
</div> 
<div class="clear"></div> 
</div> 
</div> 
在 上 传 图 片 的 对 话 框 中 单 击 上 传 文件 后 ， 将 调用 ajaxFileUpload 方 法 ， 如 代码 清单 7-10 所 示 。 其 中 的 链接 地 址 “/pic/uploadPic” 将 调用 文件 上 传 控 制 器 ， 实 现 文件 上 传 功能 。 


























代码 清单 7-10 上传 文 件 的 Ajax 方法 定义 











function ajaxFileUpload (iqd){ 


Var url = '/pic/uploadPic'; 

$.ajaxFileUpload ({ 
url ; url, // 需要 链接 到 服务 器 地 址 
fileElementId : id,， // 文件 选择 框 的 id 属性 
dataType : 'json', // 服务 器 返回 的 格式 ， 可 以 是 json 
success : function(data) { 


if (data.errorMsg) { 


showMsg (data.errorMsg， "错误 "); 


}else{ 


page.upload.finish (data.pathIinfo, data.width, data.height); 























3. 上 传 图 片 控制 器 设计 
上 传 图 片 控制 器 的 设计 ， 将 调 





























filename: 这 是 FastefsClient 使 








的 与 FastFDS 服 务 器 进行 交互 通信 时 使 



































它 由 组 名 、 路 径 和 文件 名 组 成 。 








的 文件 路 径 ， 











pathHead+filename: 这 是 可 以 在 浏览 器 的 页 面 上 使 


将 在 数据 库 中 保存 filename 和 pathHead 这 两 个 








代码 清单 7-11 上 传 图 片 控制 器 设计 




















的 完整 


网 


片 文件 路 径 ， 









































的 返 


回 





参数 中 ， 使 








属性 ， 在 页 面 视图 中 调 























7.2.2 节 定义 的 FastefsClient 服 务 类 ， 直 接 与 FastF DS 服 务 器 打交道 ， 如 代码 清单 7-11 所 示 。 这 里 必须 注意 区 别 以 下 两 种 类 型 的 文件 路 径 : 


pathHead 由 Tracker Server 的 域名 或 IP 地 址 及 其 端口 组 成 。 





了 pathlnfo (pathHead+filename) 参数 返回 文件 的 完整 路 径 。 





@Value ("${file.path.head:http://192.168.1.214:84/}") 


private String pathHead; 
@Autowired 

private FastefsClient fastefsClient; 
@RequestMapping (value = 


"/uploadPic", method = RequestMethod.POST) 


public void uploadPic (QRequestParam ("pictureFile") MultipartFile multipartFile,HttpServletRequest request,HttpServletResponse response) { 


try { 
String filename = 
Long shopid = 1L; 


BufferedImage image = 


fastefsClient .uploFile (multipartFile); 


ImageIO.read (multipartFile.getIinputStream()); 


Map<String, Object> data = new HashMap<String, Object>(); 
data.put ("pathInfo", pathHead+filename); 
data.put ("width", image.getWidth()); 
data.put ("height", image.getHeight ()); 
ObjectMapper mapper = new ObjectMapper (); 
String ret = mapper.writeValueAsString (data); 
response.setContentType ("text/html;charset=utf8"); 
response.getOutputStream() .write (ret .getBytes ()); 
response.flushBuffer (); 

}catch (IOException e){ 
e.printStackTrace (); 

} 





4. 上 传 图 片 效 果 图 


上 面 设 计 最 终 的 运行 效果 如 图 7-2 所 示 。 因 为 使 用 了 定制 的 方式 ， 也 就 是 使 用 图 片 选择 框 重新 选择 和 调整 上 传 的 图 片 ， 所 以 这 个 过 程 完成 后 ， 后 台 会 对 已 经 上 传 的 文件 进行 裁剪 ， 裁 前后 删除 原来 的 旧 文 
件 ， 并 保存 裁剪 下 来 的 新 文件 。 


























图 7-2 使 用 定制 方式 上 传 图 片 的 效果 





7.4 使 用 富 文本 编辑 器 上 传 图 片 





在 实际 应 用 中 ， 常 常 需要 使 用 富 文本 编辑 器 来 编辑 一 些 比较 复杂 的 内 容 ， 例 如 在 实例 中 ， 对 商品 内 容 的 描述 可 能 既 有 文字 说 明 ， 又 有 图 片 展 示 。 在 富 文本 编辑 器 中 上 传 图 片 ， 具 体 取决 于 编辑 器 本 身 的 
设计 。 当 然 ， 一 般 富 文本 编辑 器 的 设计 都 有 一 些 可 供 配 置 的 选项 ， 例 如 ，Ueditor 就 是 一 个 完全 开源 的 可 以 定制 的 富 文本 编辑 器 。 


7.4.1 ”使 用 富 文本 编辑 器 


使 用 Ueditor 的 页 面 ， 必 须 加 入 一 些 JS 的 引用 和 配置 。 因 为 在 商品 新 建 和 编辑 页 面 中 都 需要 使 用 Ueditor， 所 以 都 必须 加 入 对 它 的 引用 ， 如 代码 清单 7-12 所 示 。 





代码 清单 7-12 使 用 ueditor 的 引用 





<script type="text/javascript" charset="utf-8"> 
window.UEDITOR HOME URL = "/ueditor/"; 
</script> 
<script type="text/javascript" charset="utf-8" th:src="@{/ueditor/editor_ 
config.js}"></script> 
<script type="text/javascript" charset="utf-8" th:src="@{/ueditor/editor 
_all,js}"></script> 





然后 在 Ueditor 的 配置 文件 editor_config.js 中 修改 上 传 图 片 的 提交 地 址 、 路 径 等 参数 ， 将 提交 地 址 指向 编写 的 控制 器 提供 的 链接 地 址 ， 代 码 如 下 : 








, imageUrl:"/pic/uploadimg" // 图 片上 传 提交 地 址 
,imagePath:"" // 图 片 修正 地 址 


,imageFieldName: "upfile" 


// 图 片 数据 的 Kkey, 需要 在 后 台 修 改 对 应 文件 的 对 应 参数 





7.4.2 ”实现 文件 上 传 


代码 清单 7-13 是 实现 使 














数 中 的 url 就 是 一 个 完整 的 图 片 路 径 。 





代码 清单 7-13 ”Ueditor 图 片上 传 控制 器 设计 





富 文本 编辑 器 的 文件 上 传 的 控制 器 设计 。 这 个 控制 器 的 设计 与 代码 清单 7-11 控 制 器 的 设计 差不多 ， 只 是 返回 的 参数 略 有 不 同 ， 以 适合 调用 者 一 一 Ueditor 的 使 









































， 其 中 返 








// ueditor 图 片上 传 


@RequestMapping (value = "/uploadimg", method=RequestMethod.POST, produces= 
"text/html;charset=UTF-8") 
public void uploadimg (QRequestParam("upfile") MultipartFile upfile,Http 
ServletRequest request,HttpServletResponse response){ 


try { 
String filename = fastefsClient.uploFile (upfile); 
Long shopid = 1L; 


Map<String, Object> data = new HashMap<String, Object>(); 


data.put ("original", upfile.getOriginalFilename()); 
data.put ("url", pathHeadt+filename); 
data.put ("title", "")y 
data.put ("state", "SUCCESS"); 
ObjectMapper mapper = new ObjectMapper (); 
String ret = mapper.writeValueAsString (data); 
response. setContentType ("text/html;charset=utf8"); 
response.getOutputStream() .write (ret .getBytes ()); 
response.flushBuffer (); 

}catch (Exception e){ 
e.printstackTrace (); 

} 









































Ueditor 上 传 图 片 的 效果 如 图 7-3 所 示 。 图 片上 传 后， 选择 图 片 ， 单 击 富 文 本 编辑 器 中 的 上 传 图 




















4 














片 按钮 ， 可 以 查看 上 传 图 片 的 简要 信息 。 














图 片 [woyno216812048WUoupUVOo7OAO 上 人 


大 图 片 建议 尺寸 : 720 像 素 400 像素 
概述 255 个 字符 以 内 





pPJ1192 168.1.214:84/group1 











7.5 “使 用 本 地 文件 库 


人 少 -|A- 罗 -加 | 画 
握 至 | 国王 本 到 | 
小 加 痢 @Q| 囊 











图 7-3 使 用 富 文本 编辑 器 上 传 图 片 效果 图 





对 于 已 经 上 传 的 图 片 ， 可 以 创建 一 个 文件 库 来 管理 ， 这 样 不 但 可 以 本 


| 





和 E 复 利用 图 








本 地 文件 库 建 模 











片 ， 还 可 以 编辑 ， 如 果 不 再 需要 了 ， 可 以 执行 删除 操作 。 
































回 














在 Neo4j 数 据 库 中 增加 一 个 用 来 保存 图 片 信息 的 图 片 节点 ， 代 码 清单 7-14 是 图 片 节点 Picture 的 实体 建 模 ， 其 中 fileName 用 来 保存 从 FastFDS 返 
分 路 径 ， 即 代码 清单 7-11 中 的 pathHead 参 数 的 值 。 















































的 文件 路 径 ，pathlnfo 用 来 保存 完整 的 文件 链接 前 半 部 

















代码 清单 7-14 图片 节 点 实体 建 模 











@NodeEntity 

public class Picture { 
@GraphId 
private Long id; 
Private String pathIinfo; 
Private String fileName; 
private int widthy 
private int height; 
Private String flag; 
@DateLong 
private Date create; 


} 





7.5.2 ”文件 保存 方法 








代码 清单 7-15 是 一 个 保存 文件 的 后 台 线 程 ， 使 用 后 台 线 程 来 执行 保存 文件 的 方法 ， 将 会 在 不 影响 界面 上 操作 的 情况 下 ， 从 后 台中 稍稍 地 执行 savePic 方 法 。 











代码 清单 7-15 ”保存 文件 的 线程 





AsyncThreadPool .getInstance () .execute (new Runnable() { 
QOverride 
public void run() { 
try { 
savePic (upfile, filename ,shopid) 7 
} catch (Exception e) { 
e.printSstackTrace (); 
} 
} 
1D); 


























savePic 方 法 的 定义 如 代码 清单 7-16 所 示 ， 它 调用 数据 库 服 务 类 PictureService， 将 文件 信息 保存 到 数据 库 中 。 其 中 使 用 ImagelO 来 读 取 文件 的 高 度 和 宽度 。 




















代码 清单 7-16 ”保存 文件 的 方法 





@Autowired 
Private PictureService pictureService; 
Private void savePic(MultipartFile multipartFile, String filename, 
Longshopid) throws Exception{ 
BufferedImage image = ImageIO.read (multipartFile.getIinputStream()); 
Picture Picture = new Picture(); 
picture.setFileName (filename); 
picture.setHeight (image.getHeight ()); 
Picture.setWidth (image.getWidth()); 
Picture.setPathInfo (pathHead); 
picture.setCreate (new Date()); 
picture.setShopid (shopid); 
pictureService.create (picture); 





数据 库 服 务 类 PictureService 的 定义 如 代码 清单 7-17 所 示 ， 它 调用 资源 库 接口 pictureRepository 和 分 页 查询 服务 类 pagesService， 提 供 增删 查 改 及 其 分 页 查询 功能 。 


代码 清单 7-17 数据库 服务 类 PictureService 





QService 
public class PictureService { 
@Autowired 
private PictureRepository pictureRepository; 
QAutowired 
Private PagesService<Picture> pagesService; 
public Picture findById(Long id) { 
return pictureRepository.findone (id); 


public Picture create (Picture picture) { 
return pictureRepository.save (picture); 


} 

public Picture Update (Picture picture) { 
return pictureRepository.save (picture); 

} 

Public void delete(Long id) { 
Picture picture = pictureRepository.findone (id); 
pictureRepository.delete (picture); 


} 
public Picture findByName (String name){ 
return pictureRepository.findByFileName (name); 
} 
public void delete (Picture picture){ 
pictureRepository.delete (picture); 
} 
public Iterable<Picture> findAll (){ 
return pictureRepository.findAll (); 


public Page<Picture> findPage (PictureQo pictureQo){ 
Pageable pageable = new PageRequest (pictureQo.getPage(), pictureQo.getSize(), new Sort(Sort.Direction.ASC, "id")); 
Filters filters = new Filters(); 
if (!StringUtils.isEmpty(pictureQo.getFileName())) { 
Filter filter = new Filter("name", pictureQo.getFileName ()); 
filters.add (filter); 


if (!StringUtils.isEmpty(pictureQo.getShopid())) { 
Filter filter = new Filter("shopid", pictureQo.getShopid()); 
filter.setComparisonOperator (ComparisonOperator .FQUALS); 
filter.setBooleanOperator (BooleanOperator .AND); 
filters.add (filter); 

} 


return pagesService.findAll (Picture.class, pageable, filters); 





7.5.3 ”文件 库 管 理 
































网 





片 ， 也 可 以 删除 。 需 要 注意 的 是 ， 删 除 





片 时 ， 不 但 要 删除 文件 库 Picture 的 图 片 信息 ， 而 且 要 删除 FastFDS 服 务 








网 





片 ， 不 需要 的 
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保存 图 片 信息 之 后 ， 可 以 取出 已 经 上 传 的 图 片 列表 ， 按 需 选择 可 用 的 
器 上 的 文件 。 





























代码 清单 7-18 是 取 图 片 列表 的 控制 器 设计 ， 它 将 返回 一 个 Page 对 象 ， 其 中 包含 Picture 列 表 ， 列 表 将 由 视图 处 理 并 按 页 显示 出 来 以 供用 户 选 择 使 用 。 
































代码 清单 7-18 ” 取 图 片 列表 控制 器 设计 








@RequestMapping (value = "/listPic", method = RequestMethod.POST) 
@ResponseBody 
public Page<Picture> listPic(PictureQo pictureQo) throws IOException{ 
Long shopid = 1L; 
pictureQo.setShopid (shopid); 
return pictureService.findPage (pictureQo); 











代码 清单 7-19 是 取 图 片 列表 的 视图 设计 部 分 的 js 编码 ， 它 从 上 面 定义 的 控制 器 中 取得 列表 后 ， 按 每 行 4 张 图 片 、 每 页 2 行 的 格式 来 显示 列表 。 











代码 清单 7-19 ” 取 图 片 列表 视图 设计 部 分 的 js 编码 





// 分 页 数据 
function getDataHtml (pageNo,pagesize) { 
$.ajax({ 
vrls “plie/listpie", 
dataType: "json", 
type: "POST", 
cache: false, 
data: {page: pageNo-1,size: pagesize || 8}, 
success: function (data) { 
Var $list = $('#upload-list') .empty(); 
$.each (data.content, function (i, v) { 
Var html = ""7 
html += '<div class="upload-item">'+ 
"<div class="img"><img src="'+ Vv.pathInfo + v.fileName + '" 
/></div>'+ 
'<p>'+v.widtht'x'+ v.height+'</p>'+ 
'<div class="selected"></div>'+ 
rejdivy'y 
$list.append($ (html)); 
]) 
Page.photos .setPosition (); 
document .getElementById ('Pagebar') .innerHTML = PageBarNumList.get 
PageBar (qata.number+1，dqata.totalPages，3， 'getDataHtml',pagesize || 8,true) 
}, 
error: function (e) {} 
DD); 














最 后 完成 的 效果 如 图 7-4 所 示 。 这 样 ， 当 在 图 片 中 单 击 选 择 一 张 图 片 后 ， 再 单 击 确定 按钮 即 可 使 用 这 张 图片 ， 单 击 删除 按钮 将 删除 这 张 图 片 。 
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二 (加 : | 局 页 











图 7-4 ”本 地 文件 库 管 理 效果 图 


7.6 ”运行 与 发 布 


本 章 实例 工程 的 完整 代码 可 以 在 IDEA 中 直接 从 GitHub 中 检 出 : https://github.com/chenfromsz/spring-boot-files.git。 


检 出 工程 后 ， 在 webapp 模 块 的 配置 文件 application.yml 中 按照 各 种 
列表 地 址 和 端口 ， 配 置 file.path.head 的 Tracker Server 浏 览 器 地 址 和 端 














， 如 代码 清单 7-20 所 示 。 





代码 清单 7-20 webapp 模 块 配置 


server: 
port: 80 

neo4] : 
datasource: 


url: http://192.168.1.221:7474 
username: neo4j 
password: 12345678 


fdfs: 
soTimeout: 1501 


connectTimeout: 601 


thumbImage: 
width: 150 
height: 150 

trackerList: 


~ 192.169,1.214:22122 


# = L192.168.1:215 


:22122 


spring.jmx.enabled: false 


file.path.head: http 


://192.168.1.214:84/ 


民 务 器 的 安装 情况 配置 连接 Neo4j 数 据 库 的 URL、 




















户 名 和 密码 ， 配 置 连接 FastFDS 分 布 式 文件 系统 的 Tracker Server 的 trackerList 





然后 在 IDEA 的 Edit Configuration 中 增加 一 个 Spring Boot 启 动 配置 ， 模 块 选择 webapp， 工 作 目录 选择 模块 所 在 的 根 目录 ， 主 程序 选择 com.test.webapp.Webapp-Application， 并 将 配置 保存 为 


webapp。 















































运行 webapp 配 置 项 


， 应 用 启动 成 功 后 ， 打 开 网 址 http://localhost， 即 可 体验 使 有 











如 果 需 要 发 布 工程 ， 可 以 在 IDEA 的 Edit Configuration 中 增加 一 个 Maven 配 置 ， 工 作 目 录 选 择 工程 根 目 录 ， 在 命令 行 输入 clean package， 并 保存 配置 为 mvn。 然 后 运行 配置 项 目 mvn， 即 可 执行 打包 























操作 。 
77 水 结 
本 章 使 用 FastFDS 安 装 一 个 分 布 式 文件 系统 ， 使 








发 现 ， 在 Spring Boot 框 架 中 使 














使 用 分 布 式 文件 系统 ， 可 以 提升 服务 系统 在 存 取 文件 方面 的 性 能 ， 但 对 于 提升 整个 服务 体系 的 性 能 来 说 ， 这 还 远 远 不 够 ， 下 一 


体 性 能 。 























FastFDS_Client 演 示 使 






































定制 方式 和 富 文本 编辑 器 的 方式 上 传 图 片 文件 的 功能 ， 
FastFDS 也 是 非常 容易 的 。 要 提高 一 个 大 型 分 布 式 系统 的 图 片 文件 访问 性 能 和 设计 一 个 可 以 动态 扩容 的 文件 系统 ， 使 用 分 布 式 文件 系统 是 最 佳 的 选择 。 


分 布 式 文件 系统 的 功能 。 

















第 8 章 云 应 用 开发 





2014 年 6 月 ，Pivotal 团 














队 正 式 发 布 了 Spring Cloud 1.0.0 版 本 。Spring Cloud 是 一 套 云 应 用 开发 工 








并 建立 一 个 本 地 文件 库 来 管理 上 传 文件 。 通 过 本 章 实例 的 演示 ， 我 们 

















二 凡 . 


将 介绍 使 





开发 工具 ， 开 发 高 可 


























集 ， 为 分 布 式 的 微服 务 开发 提供 了 一 整套 简 和 











站 易 用 的 使 用 工 











服务 发 现 、 动 态 路 由 、 负 载 均衡 、 断 路 器 、 安 全 管理 、 事 件 总 线 、 分 布 式 消息 等 组 件 的 开发 工具 包 。 


表 8-1 列 出 了 Spring Cloud 组 件 和 对 应 的 版 本 ， 在 第 5 章 的 安 
starter-parent 方 式 来 简化 工程 的 依赖 配置 ， 我 们 使 


C 


spring-cloud-aws 
spring-cloud-bus 
spring-cloud-cli 
spring-cloud-commons 
spring-cloud-config 
spring-cloud-netflix 


spring-cloud-security 











管理 和 第 6 章 的 SSO 设 计 中 使 
































了 其 中 的 spring-cloud-secutiry。Spring Cloud 在 Brixton.M4 版 本 之 后 ，Maven 可 以 使 
的 Spring Cloud 版 本 是 Brixton.M5， 对 应 的 Spring Cloud 版 本 是 1.1.0，Spring Boot 的 版 本 是 1.3.2。 


表 8-1 Spring Cloud 组 件 列表 


omponent 
































Brixton.BUILD-SNAPSHOT 


1.1.1.BUILD-SNAPSHOT 
1.1.1.BUILD-SNAPSHOT 
1.1.1.BUILD-SNAPSHOT 
1.1.1.BUILD-SNAPSHOT 
1.1.1.BUILD-SNAPSHOT 
1.1.1.BUILD-SNAPSHOT 
1.1.1.BUILD-SNAPSHOT 





的 微服 务 ， 以 提升 服务 系统 整 


。 Spring Cloud 主 要 包含 配置 管理 、 


spring-cloud- 


Nn 


( 续 ) 


Component Brixton.BUILD-SNAPSHOT 

spring-cloud-starters | 106RELIEASE | 

spring-cloud-cloudfoundry | 100RELEASE | 1.0.1.BUILD-SNAPSHOT 
spring-cloud-cluster | 0.0RELEASE | 1.0.1.BUILD-SNAPSHOT 
spring-cloud-consul | 100RELEASE | 1.0.1.BUILD-SNAPSHOT 
spring-cloud-sleuth | | 100RELEASE | 1.0.1.BUILD-SNAPSHOT 
spring-cloud-stream | 100RELEASE | 1.0.1.BUILD-SNAPSHOT 
spring-cloud-zookeeper | 100RELEASE | 1.0.1.BUILD-SNAPSHOT 
spring-boot 1.3.5.RELEASE 
spring-cloud-stream-app-starters* | 1.0.0.BUILD-SNAPSHOT 
spring-cloud-task* | | 1.0.0BUILD-SNAPSHOT 


(上 面 资料 来 源 : http://projects.spring.io/spring-cloud/#quick-start) 

















Spring Cloud 与 Spring Boot 关 系 密切 ， 能 够 至 于 完美 的 结合 使 用 。 









































本 章 的 实例 工程 使 用 了 模块 化 设计 ， 用 来 介绍 Spring Cloud 工 具 集 中 几 个 主要 组 件 的 具体 使 有 














， 如 表 8-2 所 示 。 
































表 8-2 ”实例 工程 模块 


ER 
数据 服务 Web 应 用 
ET 


8.1 ”使 用 配置 管理 














为 客户 
为 客 } 








功能 
! 端 提供 配置 管理 及 更 新 服务 
1 端 提 供 注 册 与 发 现 服 务 等 功能 


为 分 布 式 服务 提供 监控 管理 等 功能 
Neo4j 数据 管理 服务 
Web 客户 端 应 用 


一 个 项 目 工程 总 是 需要 一 些 配置 ， 例 如 ， 要 配置 服务 器 的 端口 、 访 问 数据 库 的 参数 或 其 他 一 些 项 目 需要 的 参数 等 。 而 一 个 大 型 的 分 布 式 系统 可 能 存在 很 多 这 样 需要 配置 的 项 目 工程 ， 这 时 ， 配 置 管理 就 
将 是 一 个 庞大 的 工程 ， 所 以 弄 不 好 很 容易 出 错 。 因 此 对 于 一 个 分 布 式 系统 来 说， 迫切 需要 一 个 单独 的 系统 来 专门 管理 各 个 项 目的 配置 。Spring Cloud 的 配置 管理 就 是 这 样 的 一 个 工具 包 。 

































































最 新 的 配置 。 


8.1.1 ”创建 配置 管理 服务 器 






































使 用 Spring Cloud 的 配置 管理 开发 工具 包 ， 只 要 创建 一 个 简单 的 工程 ， 就 可 以 实现 分 布 式 配置 管理 服务 ， 它 还 支持 在 线 更 新 ， 即 如 果 更 新 了 配置 文件 ， 使 用 这 个 配置 文件 的 客户 端 不 用 重启 就 可 以 使 












































为 了 给 客户 端 提供 配置 管理 的 服务 ， 要 创建 一 个 工程 ， 用 来 构建 一 个 配置 管理 服务 器 。 首 先 ， 在 工程 的 Maven 管 理 中 引用 如 代码 清单 8-1 所 示 的 依赖 配置 。 


代码 清单 8-1 配置 管理 服务 器 依赖 配置 





<dependency> 
<groupId>org.springframework.cloud</groupId> 
<artifactId>spring-cloud-config-server</artifactId> 
</dependency> 





然后 ， 创 建 一 个 主 程序 ， 如 代码 清单 8-2 所 示 。 这 是 这 个 工程 中 我 们 创建 的 唯一 一 个 类 ， 其 中 注解 @EnableConfigserve 启 
客户 端 功能 ， 表 明 这 是 使 用 发 现 服务 的 一 个 客户 端 。 




















代码 清单 8-2 ”配置 管理 服务 器 主 程序 




















了 配置 管 























有 服务 的 功能 ， 注 解 @Enable-DiscoveryClient 启 用 了 发 现 服务 的 





@SpringBootApplication 

@EnableConfigServer 

QEnableDiscoveryClient 

public class ConfigApplication{ 
public static void main(String[] args) { 

SpringApplication.run (ConfigApplication.class, args); 

} 

} 














这 样 ， 就 创建 了 一 个 配置 管理 服务 器 。 它 能 为 客户 端 提供 配置 文件 的 管理 和 更 新 等 服务 。 















































配置 管理 服务 器 中 使 用 的 文件 格式 与 工程 的 本 地 配置 文件 格式 一 样 ， 既 可 以 使 用 “.properties” 扩 展 名 ， 也 可 以 使 用 “.yml” 扩 展 名 。 配 置 文件 的 存储 目前 支持 使 用 本 地 存储 、Git 以 及 Subversion 等 方 
式 。 在 实例 中 ， 将 使 用 Git 的 方式 来 存 取 配 置 文件 ， 这 需要 在 Git 服 务 器 上 创建 一 个 资源 库 ， 并 将 配置 文件 上 传 到 创建 的 资源 库 中 。 为 了 方便 演示 配置 管理 服务 的 功能 ， 将 配置 文件 存放 在 GitHub 中 。 如 果 是 
实际 应 用 ， 建 议 使 用 自主 创建 的 Git 服 务 器 。 







































































在 配置 管理 服务 器 的 本 地 工程 配置 文件 中 ， 进 行 如 代码 清单 8-3 所 示 的 设置 ， 其 中 “uri” 指 定 资源 库 的 位 置 。 








代码 清单 8-3 ”文件 资源 库 配置 


spring: 
cloud: 
config: 
server: 
git: 
uri: https://github.com/chenfromsz/spring-cloud-config 
-repo 











该 资源 库 包含 如 下 文件 ， 并 且 为 了 演示 目的 ， 文 件 中 有 一 些 简单 的 配置 内 容 。 要 查看 配置 文件 的 内 容 ， 可 以 在 浏览 器 中 输入 如 代码 清单 8-3 所 示 的 uri。 关 于 如 何 使 用 这 些 配置 文件 ， 将 在 下 一 小 节 中 介 












































绍 


Application.yml 
web.yml 
web-development .yml 
data.yml 
data-development .yml 





8.1.2 ”使 用 配置 管理 的 客户 端 





















































客户 端 要 使 用 配置 管理 服务 ， 首 先 要 在 工程 中 的 Maven 依 赖 管理 中 加 入 配置 管理 组 件 spring-cloud-starter-config 的 依赖 ， 如 代码 清单 8-4 所 示 。 使 用 配置 管理 服务 之 后 ， 如 果 本 地 的 配置 文件 与 配 
管理 服务 器 的 配置 文件 有 相同 的 配置 项 ， 将 优先 使 用 配置 管理 服务 器 的 配置 项 ， 也 就 是 说 本 地 的 配置 项 将 会 被 覆盖 。 



























































代码 清单 8-4 ”使 用 配置 管理 的 客户 端 依赖 配 








<dependency> 
<groupId>org.springframework.cloud</groupId> 
<artifactId>spring-cloud-starter-config</artifactId> 
</dependency> 






























































其 次 ,使 用 配置 管理 的 客户 端 必须 在 本 地 的 配置 中 ， 事 先 做 好 连接 配置 管理 服务 器 ， 以 及 需要 使 用 由 配置 管理 服务 器 提供 的 配置 文件 等 参数 的 设 定 。 






































各 个 使 用 配置 管理 的 客户 端 项 目 中 一 个 名 为 bookstrap.yml 的 本 地 配置 文件 ， 就 是 用 来 设 定 连接 配置 管理 服务 器 、 应 用 的 名 称 ， 以 及 需要 由 配置 管理 服务 器 提供 的 配置 文件 等 参数 的 ， 如 代码 清单 8-5 所 
。 配置 中 的 一 些 参数 解释 如 下 : 








| 





uri: 设 定 连接 配置 管理 服务 器 的 地 址 和 端口 。 





























name: 用 来 指定 应 用 的 名 称 和 配置 文件 的 名 称 。 


















































profiles: 可 以 理解 为 使 用 配置 文件 名 称 的 后 缀 部 分 。 例 如 这 个 配置 本 身 ， 因 为 profiles 设 定 了 development， 所 以 它 使 用 的 配置 文件 将 是 web-development.yml 或 web-development.properties。 如 
果 不 使 用 profiles 这 个 参数 ， 即 使 用 没有 文件 名 后 缀 部 分 的 配置 文件 ， 例 如 ， 这 个 配置 将 使 用 web.yml 或 web.properties 配 置 文 件 。 













































































如 果 在 资源 库 中 有 application.yml| 或 application.properties 文 件 ， 则 默认 加 载 。 









































另外 ， 也 可 以 在 config 参 数 下 面 使 用 name 和 profiles 来 指定 配置 文件 的 名 称 和 后 缀 ， 即 与 上 面 的 应 用 名 称 分 开 进 行 配 置 。 这 里 使 用 上 面 的 配置 方法 。 


































































































使 用 name 和 profiles 这 两 个 参数 ， 可 以 设 定 不 同 环境 使 用 不 同 的 配置 文件 ， 这 对 于 在 开发 环境 中 和 在 生产 环境 中 使 用 不 同 的 配置 文件 来 说 ， 是 很 方便 的 ， 只 要 更 改 profiles 参 数 即 可 。 









































代码 清单 8-5 ”客户 端 使 用 配置 管理 的 设 








spring: 
application: 
name: we 
profiles: 
active: development 
cloud: 
config: 
uri: http://localhost:8888 

























































































设 定 这 些 配 置 参数 之 后 ， 就 可 以 使 用 配置 管理 服务 器 提供 的 服务 了 。 可 以 像 下 面 的 程序 片段 那样 ， 在 需要 用 到 配置 的 地 方 引 用 配置 文件 中 的 配置 项 ， 这 个 引用 假设 配置 文件 中 包含 cloud.sample.msg 这 
个 配置 。 











@Value ("${cloud.sample.msg}") String msg; 
String configValue = environment .getProperty ("cloud.sample.msg", "undefined"); 


Ot 总 对 于 客户 端 中 的 一 些 启动 参数 的 配置 ， 如 应 用 服务 的 端口 设 定 、 数 据 库 的 连接 地 址 、 用 户 和 密码 等 配置 是 在 工程 启动 时 加 载 ， 并 且 中 途 不 能 变更 ， 所 以 这 些 启动 参数 虽然 可 以 使 用 配置 管理 的 
配置 ， 但 不 能 使 用 自动 更 新 功能 ， 这 应 该 是 可 以 理解 的 。 





测试 上 述 一 些 配 置 的 功能 ,首先 启动 实例 工程 的 config 模 块 ， 然 后 启动 web 模 块 ， 这 时 在 它们 的 控制 台 上 都 可 以 看 到 加 载 了 下 列 配置 文件 : 


web-development .yml 
web.yml 
application.yml 












































虽然 web.yml 也 被 加 载 了 ， 但 是 因为 只 是 调用 了 web-development.yml， 所 以 只 有 这 个 文件 的 配置 内 容 才 会 被 读 取 。 可 以 使 用 一 个 测试 程序 来 验证 一 下 ， 如 代码 清单 8-6 所 示 ， 我 们 设计 了 一 个 控制 
器 。 控 制 器 提供 了 一 个 链接 地 址 “/test” ， 当 访问 这 个 地 址 时 ， 将 从 配置 文件 中 读 取 配 置 参数 “cloud.sample.msg” 的 值 ， 并 做 出 相应 输出 ， 如 果 读 取 失 败 ， 将 取 默 认 值 World。 












































代码 清单 8-6 ”使 用 配置 管理 的 测试 程序 1 





Q@RestController 


Public class TestController { 
@Value ("${cloud.sample.msg:World}") String msg; 
@RequestMapping ("/test") 
String test() { 
return "Hello " + msg + "!"; 


} 








在 浏览 器 上 输入 网 址 http://localhost:9001/test， 因 为 在 同一 台 机 器 上 演示 ，web 项 目 使 用 了 9001 的 端口 。 














假如 在 配置 文件 web-development.yml 或 application.yml 中 包含 “cloud.sample.msg” 配置 项 ， 就 会 输出 它 的 值 ， 否 则 输出 : Hello World! 现在 web-development.yml 包 含 如 下 的 内 容 : 


cloud: 
sample: 
msg: web-development 





即 上 面 浏览 器 正确 的 输出 结果 应 该 是 如 下 的 结果 ， 这 正 是 我 们 期 望 得 到 的 输出 结果 。 





Hello web-development! 





Oi 如 果 和 暂时 不 需要 使 用 配置 管理 服务 器 提供 的 配置 ， 只 想 使 用 本 地 的 配置 文件 ， 可 以 只 把 代码 清单 8-4 中 的 依赖 注释 掉 即 可 。 


8.1.3 ”实现 在 线 更 新 




















上 一 小 节 对 配置 管理 服务 器 的 配置 文件 的 读 取 ， 只 有 在 应 用 启动 时 才 会 加 载 。 这 显然 是 不 够 理想 的 ， 能 不 能 在 应 用 不 重启 的 情况 下 ， 在 线 更 新 配置 呢 ? 当然 是 可 以 的 。 要 实现 在 线 更 新 ， 必 须 在 需要 使 
更 新 配置 的 Bean 中 增加 一 个 注解 : @RefreshScope， 即 将 代码 清单 8-6 改 成 代码 清单 8-7。 














从 


























代码 清单 8-7 ”使 用 配置 管理 的 测试 程序 2 





@RestController 
Q@RefreshScope 
public class TestController { 
@Value ("${cloud.sample.msg:World}") String msg; 
@RequestMapping ("/test") 
String test() { 
return "Hello " + msg + "!"; 


} 





通过 这 样 更 改 之 后 ， 再 来 测试 一 下 。 启 动 实例 工程 的 web 模 块 之 后 ， 再 将 上 面 配 置 文 件 的 内 容 修改 成 如 下 ， 并 提交 到 Git 服 务 器 上 。 








cloud: 
sample: 
msg: web-develop 


























现在 刷新 上 面 的 浏览 器 还 不 能 读 取 到 最 新 的 配置 ， 因 为 在 线 更 新 还 必须 使 用 一 个 指令 来 触发 。 使 用 下 列 的 指令 才能 触发 更 新 ， 使 用 这 个 指令 之 后 ， 可 以 在 web 模 块 的 控制 台 上 看 到 重新 加 载 了 配置 文 
件 。 这 时 候 再 刷新 浏览 器 ， 就 可 以 看 到 输出 了 我 们 期 望 的 结果 : Hello web-develop! 





























curl -X POST http://localhost:9001/refresh 


Oi cufl 是 UNIX 系 统 的 指令 ， 上 面 指令 需要 使 用 POST 方式 传送 ， 执 行 上 面 指令 需要 有 Linux 类 型 的 系统 。 如 果 你 的 机 器 是 Windows 系 统 ， 也 不 用 担心 ， 如 果 已 经 安装 了 Git 客 户 端 ， 打 开 Git Bash 窗 
口 ， 同 样 也 能 使 用 UNIX 指 令 。 注 意 上 面 指令 参数 的 大 小 写 敏感 。 


8.1.4 ”更 新 所 有 客户 端的 配置 
















































































使 用 上 面 的 方法 ， 如 果 有 很 多 应 用 ， 就 需要 一 个 一 个 地 触发 更 新 配置 ， 相 当 麻 烦 。 有 没有 一 种 方法 ， 可 以 更 新 所 有 使 用 配置 管理 的 客户 端 配置 呢 ? 使 用 事件 总 线 Spring-cloud-bus， 就 可 以 在 线 更 新 所 
有 连接 配置 管理 服务 器 的 客户 端 。 这 样 ， 仪 仅 使 用 一 条 指令 就 可 以 更 新 所 有 客户 端的 配置 。 




































































因为 spring-cloud-bus 是 使 用 分 布 式 消息 发 布 机制 ， 通 过 RabbitMQ 使 用 消息 分 发 的 方法 来 执行 更 新 的 。 所 以 还 必须 安装 Rabbit MQ 服务 器 ， 才 能 实现 消息 分 发 。RabbitMQ 服 务 器 的 安装 可 以 参照 附 





录 D。 



































启用 spring-cloud-bus 的 功能 ， 首 先 在 配置 管理 服务 器 和 所 有 使 用 配置 管理 的 客户 端的 Maven 依 赖 管理 中 ， 都 要 增加 如 代码 清单 8-8 所 示 的 依赖 配置 。 


代码 清单 8-8 spring-cloud-bus 依 赖 配置 





<dependency> 
<groupId>org.springframework.cloud</groupId> 
<artifactId>spring-cloud-starter-bus-amqp</artifactId> 
</dependency> 




















其 次 ， 在 配置 管理 服务 器 和 所 有 连接 配置 管理 服务 器 的 客户 端的 本 地 配置 文件 中 ， 增 加 如 代码 清单 8-9 所 示 的 配置 ， 即 设 定 连接 RabbitMQ 服 务 器 的 IP、 端 口 、 用 户 名 和 密码 等 参数 。 





























代码 清单 8-9 连接 RabbitM Q 服 务 器 的 配置 


spring: 
rabbitmq: 
addresses: amqp://192.168.1.214:5672 
username: alan 
password: alan 














上 面 配置 假设 你 已 经 安装 了 RabbitMQ 服 务 器 ， 安 装 的 IP 地 址 为 192.168.1.214， 使 用 默认 端口 为 5672， 增 加 了 一 个 用 户 ， 用 户 名 和 密码 都 为 alan， 并 且 为 用 户 赋予 了 可 以 使 用 消息 服务 的 权限 。 






































通过 网 址 http://192.168.1.214:15672 使 用 浏览 器 打开 RabbitMQ 服 务 器 ， 并 使 用 管理 员 用 户 登 录 进 去 ， 就 可 以 打开 RabbitMQ 服 务 器 的 控制 台 ， 在 这 里 可 以 查看 连接 的 客户 端 和 通道 等 信息 ， 如 图 8-1 
所 示 。 
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图 8-1 


























现在 可 以 使 











下 列 指 令 ， 更 新 所 有 在 线 的 使 





配置 管理 的 客户 端 了 ， 假 设 配置 管理 服务 器 的 端口 为 8888。 


curl -X POST http://localhost:8888/bus/refresh 


RabbitMQ 服 务 器 连接 通道 情 





0 
0 
0 0.00/s 


况 


























执行 指令 后 ， 可 以 在 配置 管理 服务 器 的 控制 





新 加 载 了 一 些 客户 端的 配置 文件 。 在 连接 配 























管理 服务 器 的 客户 端的 控制 台中 同样 可 以 看 到 





























在 本 章 的 实例 工程 中 ， 可 以 使 用 web 和 data 两 个 模块 来 测试 这 个 更 新 指令 。 执 行 指令 后 ， 可 以 看 到 两 个 模块 的 配 
已 经 被 更 新 了 。 如 果 你 还 不 放心 ， 也 可 以 使 用 上 一 小 节 的 测试 程序 来 验证 一 下 ， 两 个 模块 都 有 相 












































管理 











上 面 这 个 指令 跟 上 一 小 节 的 更 新 指令 有 点 不 同 ， 主 要 体现 在 两 点 : 第 一 ， 它 必须 使 








配 

















但 是 ， 有 时 我 们 并 不 想 一 下 子 就 更 新 所 有 的 客户 端 ， 
如 ， 下 面 的 指令 指定 更 新 名 称 为 web 的 应 用 的 所 有 更 新 ， 


可 能 只 需要 更 新 一 个 客户 端 ， 这 时 既 可 以 使 
它 使 用 了 destination 参 数 。 












































同 的 测试 程序 ， 即 在 浏览 器 中 使 
民 务 器 的 地 址 来 执行 ， 第 二 ， 它 的 


上 一 小 节 的 更 新 指令 ， 也 可 以 在 配置 管理 服务 器 中 使 


新 加 载 了 配置 文件 。 





文件 都 被 重新 加 载 了 ， 不 管 配置 文件 有 没有 更 改 。 这 样 其 实 也 就 可 以 证 明 客 户 端的 配 











“/test” 链 接 来 测试 。 





URL 中 多 了 一 个 “bus”。 























指定 目标 客户 端 来 更 新 一 个 客户 端的 配置 。 例 





curl -X POST http://localhost:8888/bus/refresh?destination=web:** 














上 面 所 有 的 在 线 更 新 都 必须 要 求 需要 使 








更 新 的 Bean 中 包含 @RefreshScope 注 解 的 才能 适用 ， 这 一 点 是 毋庸 置疑 




















的 。 











关于 配置 管理 的 其 他 一 些 内 容 ， 比 如 ， 对 配置 文件 的 读 取 还 可 以 使 














安全 措施 和 策略 ， 如 设置 数字 签名 、 








cloud.html# security 2。 


8.2 ”使 用 发 现 服务 








在 分 布 式 系统 中 ， 可 能 存在 很 多 应 
由 服务 提供 者 一 方 对 外 暴露 接口 




















， 然 后 由 服务 消费 者 一 方 对 接口 





进行 访问 ， 从 而 达到 数据 共享 的 目的 。 但 是 不 管 使 
































而 使 用 Spring Cloud， 通 过 发 现 服务 来 实现 服务 之 间 的 数据 共享 是 轻而易举 的 。 
8.2.1 ”创建 发 现 服务 器 
使 用 发 现 服务 的 功能 ， 需 要 创建 一 个 工程 ， 用 来 构建 一 个 发 现 服务 器 ， 在 工程 中 需要 引 















































代码 清单 8-10 ”发 现 服务 器 的 依赖 配置 





和 服务 ， 而 各 个 服务 都 独立 自主 地 管理 自身 的 数据 。 在 服务 与 服务 之 间 ， 有 时 候 可 能 需要 互相 共享 一 些 数据 ， 传 统 的 做 法 是 使 














户 名 和 密码 等 ， 可 参考 官方 文档 : http://projects.spring.io/spring-cloud/spring- 


Webservice， 或 者 SOAP 的 方式 ， 











上 面 哪 种 方式 ， 开 发 者 都 必须 编写 一 些 接口 








如 代码 清单 8-10 所 示 的 Maven 依 赖 配置 。 





程序 ， 可 能 还 需要 使 





复杂 的 配置 来 实现 。 








<dependency> 
<groupId>org.springframework.cloud</groupId> 
<artifactId>spring-cloud-starter-eureka-server</artifactId> 
</dependency> 





然后 创建 一 个 简单 主 程序 ， 并 在 主 程序 中 增加 注解 @EnableEurekaServer， 即 启用 发 现 服务 器 的 功能 ， 如 代码 清香 





8-11 所 示 。 





代码 清单 8-11 发现 服 务 器 主 程序 





@SpringBootApplication 
Q@EnableEurekaServer 
public class DiscoveryApplication { 
public static void main(String[] args) { 
SpringApplication.run (DiscoveryApplication.class, args); 





8.2.2 ”使 用 发 现 服务 的 客户 端 配置 


















































1) 使 





发 现 服务 器 的 客户 端 ， 首 先 需要 在 工程 中 引 





如 代码 清单 8-12 所 示 的 Maven 依 赖 配置 ， 发 现 服务 








来 使 








代码 清单 8-12 ”使 用 发 现 服务 器 的 客户 端 依赖 配置 


器 提供 的 功能 。 


<dependency> 
<groupId>org.springframework.cloud</groupId> 
<artifactId>spring-cloud-starter-eureka</artifactId> 
</dependency> 











2) 在 工程 的 主 程序 中 ， 增 加 一 个 注解 @EnableDiscoveryClient， 以 启用 发 现 服务 的 客户 端 功能 。 














3) 在 工程 的 配置 文件 中 配置 发 现 服务 器 的 地 址 和 端口 ， 如 代码 清单 8-13 所 示 。 假 设 发 现 服务 器 在 本 地 运行 ， 并 且 端 口 为 8761。 




















代码 清单 8-13 ”使 用 发 现 服务 的 客户 端 配置 








eureka: 
Clienk: 
serviceUrl: 
defaultZone: http://localhost:8761/eureka/ 
instance: 
preferIpAddress: true 


4) 在 bookstrap.yml 配 置 文 件 中 ， 配 置 应 用 的 名 称 (应 用 名 称 的 配置 与 使 用 配置 管理 服务 器 的 配置 相同 ， 可 以 参考 代码 清单 8-5) ， 代 码 如 下 。 这 个 名 称 就 是 一 个 应 用 在 发 现 服务 器 中 的 一 个 唯一 标 
识 ， 必 须 保证 它 的 唯一 性 。 














spring: 
application: 
name: web 


8.2.3 ”发 现 服务 器 测试 








要 测试 发 现 服 务 器 ， 首 先 启动 实例 工程 中 的 discovery 项 目 ， 然 后 启动 config、data、web 等 项 目 ， 如 果 各 个 服务 器 和 客户 端 都 运行 了 ， 在 浏览 器 中 打开 地 址 http://localhost:8761， 即 可 打开 发 现 服务 
器 的 控制 台 。 




















现在 就 可 以 看 到 如 图 8-2 所 示 的 情况 ， 这 里 可 以 看 到 已 经 注册 的 CONFIG、DATA、WEB 三 个 服务 ， 分 别 对 应 实例 工程 的 配置 服务 、 数 据 服务 、Web 服 务 三 个 模块 的 实例 。 











© Selglale Eureka LAST 1000 SINCE STARTUP 


System Status 


Environment Current time 2016-05-20T06;45-52 *0000 
Data center Upume 

Lease expiration enabled 

Renews threshold 


Renews (last min) 


DS Replicas 
Instances currently registered with Eureka 


Application Availability Zones Status 
(1) UP (1) - Alan-PC:config:8888 
(1) UP (1) - Alan-PC:dara-9000 


(1) UP (1) - Alan-PC-web:9001 





图 8-2 发现 服务 器 控制 台 


8.3 ”使 用 动态 路 由 和 断路 器 








8.2 节 创建 了 一 个 发 现 服务 器 ， 并 向 其 注册 了 几 个 微服 务 (客户 端 ， 这 一 节 将 介绍 如 何在 这 些 服务 之 间 ， 使 用 动态 路 由 、 断 路 器 和 故障 容错 等 功能 。 





























当 客 户 端 发 现 服务 器 注册 之 后 ， 客 户 端 之 间 就 可 以 通过 Zuul 路 由 代理 协议 ， 使 用 应 用 的 名 称 来 访问 各 自 的 REST 资 源 。 





























8.3.1 依赖 配置 




















启用 动态 路 由 、 断 路 器 和 服务 监控 等 功能 ， 首 先 需要 在 各 个 客户 端的 工程 中 引用 如 代码 清单 8-14 所 示 的 Maven 依 赖 配置 。 






































代码 清单 8-14 ”启用 路 由 和 断路 器 等 的 依赖 配置 











<dependency> 
<groupId>org.springframework.cloud</groupId> 


<artifactId>spring-cloud-starter-zuul</artifactId> 
</dependency> 
<dependency> 
<groupId>org.springframework.cloud</groupId> 
<artifactId>spring-cloud-starter-hystrix</artifactId> 
</dependency> 



































其 次 在 各 个 使 用 上 述 功能 的 工程 的 主 程序 中 ， 增 加 如 下 注解 ， 即 可 启用 路 由 代理 服务 和 启用 监控 服务 功能 。 
































@EnableZuulProxy 
@EnableHystrix 





8.3.2 ”共享 REST 资 源 






































哆 












































在 实例 工程 的 data 模 块 ， 使 用 Neo4j 图 形 数据 库 ， 创 建 了 三 个 节点 ， 分 别 是 单位 、 用 户 、 角 色 ， 并 创建 了 两 个 关系 ， 即 用 户 隶 属于 单位 的 关系 和 用 户 拥有 角色 的 关系 。 有 关节 点 和 关系 的 实体 建 模 如 表 


8-3 所 示 。 


表 8-3 ”实体 建 模 列 表 


备注 


Se 
隶属 关系 


i 
i 
E> 
ei 


点 : 用 户 


拥有 关系 re 
j 有 天 鼻 结束 节点 : 角色 



































节点 和 关系 实体 的 持久 化 ， 可 以 使 用 资源 库 的 方式 实现 。 代 码 清单 8-15 是 用 户 节点 的 持久 化 实现 ， 并 且 在 实现 持久 化 的 同时 也 共享 了 REST 资 源 。 其 中 注解 @Reposit-oryRestResource 标 注 这 个 接口 不 
但 是 一 个 数据 库 的 资源 库 ， 也 是 一 个 REST 资 源 共享 ， 并 把 资源 的 名 称 和 路 径 定义 为 users。 将 在 下 一 小 节 中 介绍 如 何 使 用 这 个 REST 的 资源 共享 。 






































代码 清单 8-15 用户 节点 的 REST 资 源 库 





@RepositoryRestResource (collectionResourceRel = "users", path = "users") 
public interface UserRepository extends GraphRepository<User> { 
User findByName (@Param("name") String name); 
QQuery ("MATCH (u:User) WHERE u.name =~ ('(?i).*'+{name}+'.*') RETURN u") 
Collection<User> findByNameContaining (@Param("name") String name); 














现在 可 以 使 用 如 代码 清单 8-16 所 示 的 测试 程序 来 为 Neo4j 数 据 库 生成 一 些 测试 数据 ， 以 方便 后 面 的 测试 。 测 试 程序 首先 清空 数据 库 的 记录 (如 果 存 在 的 话 ) ， 然 后 创建 一 个 单位 命名 为 “开发 部 ”， 创 
建 两 个 角色 分 别 是 admin 和 manage， 创 建 一 个 用 户 ， 用 户 名 为 user， 将 用 户 “ 安 排 ”到 单位 “开发 部 ”中 ， 并 给 它 “ 分 配 ”两 个 角色 为 admin 和 manage。 























代码 清单 8-16 ”Neo4 测 试 程序 





@Autowired 

UnitRepository unitRepository; 

@Autowired 

RoleRepository roleRepository; 

@Autowired 

UserRepository userRepository; 

Q@Test 

Public void initData() { 
userRepository.deleteAll () 
roleRepository.deleteAll () 
unitRepository.deleteAll (); 
Unit unit = new Unit(); 
unit.setName ("开发 部 "); 
unit.setCreate (new Date () 
unitRepository.save (unit) 
Assert .notNull (unit .getId 
Role role = new Role(); 
role.setName ("admin") 7 
role.setCreate (new Date () ) 7 
roleRepository.save (role) 7 
RAssert .notNul1l (role.getId()); 
Role rolel = new Role() 7 
rolel.setName ("manage"); 
rolel .setCreate (new Date( 


) 7 
()) 7 


) ) 7 
roleRepository.save (rolel); 
Assert .notNull (rolel .getId( 
User user = new User(); 
user.setName ("user"); 
user.setSex (1); 
user.setEmail ("user@email .com"); 
user.setCreate (new Date()); 
user.beBelong (unit, "安排 "); 
user.addOowner (role， "分 配 "); 
user.addOowner (role1， "分 配 ") 7 
UserRepository.save (user); 
Assert .notNull (user.getId()); 


)); 








运行 测试 程序 ， 可 以 生成 一 些 测试 数据 。 数 据 生成 后 ， 启 动 data 模 块 ， 然 后 在 浏览 器 中 输入 网 址 : http://localhost:9000/users。 











现在 可 以 看 到 如 图 8-3 所 示 的 资源 数据 ， 从 图 中 可 以 看 出 ， 可 以 使 用 下 列 链 接 来 访问 这 些 资源 数据 。 





























http://localhost:9000/users/132 
http://localhost:9000/users/search/findByName?name=user……. 





| @# localhost9000/users X We 


€ 3 CC 0D le wml/ 


}, { 
“ " : “分 村”， 
“create” : “2016-05-19T09:32:04.748+0000", 


“ 得 
UsSer  ， 


} 


“ 


3 

role” : 

“name”: "manage”, 

“create”: “2016-05-19T09:32:04.736+0000" 


} 5 
: { 
“nanme”: “安排 *， 
“create” :; “2016-05-19T09:32;04.748+0000", 
“unit”: { 
“@d :; “4", 
“name”: “开发 部 "， 
“create” ; “2016-05-19T09:;32;04.643+0000" 
3 
"user” : { 
“"@ref” : “1° 


ks 
”links” : { 
“self" : { 
“href”: “http://localhost: 9000/users/132" 
“user” : { 
“href” :; “http://1localhost:9000/users/132" 


“totalElemerts” : 1, 
“totalPages” : 1, 
“mmber” : 0 


图 8-3 节点 实体 User 的 REST 资 源 








如 果 这 时 启动 web 模 块 ， 然 后 使 
以 在 web 模 块 中 ， 像 使 用 本 地 数据 一 样 使 用 data 模 块 的 数据 。 














用 链接 http://localhost:9001/data/users， 同 样 可 以 看 到 类 似 图 8-3 所 示 的 样子 ， 只 不 过 这 时 是 在 web 模 块 打开 的 链接 ， 而 不 是 data 模 块 ， 如 图 


8-4 所 示 。 也 就 是 说 ， 可 





$5 引 
“name”: “分配 ”， 
“create”: “2016-05-19T09:32:04.748+0000", 
"user” : { 
"Bref” : “1” 
}, 
"Fols” 过 二 
“和 
"name” : "mamage”, 
“create” :; “2016-05-19T09:32:04.736+0000" 
} 
| 
“belone” : { 
“name”:“ 安 排 *， 
“create”: "2016-05-19T09:32:04.748-+0000", 
“unit”: { 
“i 
“name”:;“ 开 发 部 “， 
“create” : “2016-05-19T09:32:04.643+0000" 
}， 
"user” : { 
“@ref” : “1” 
} 
5 
”links”: 1 
“self”: { 
“href”: "http:// localhost: 9001/data/users/ 132" 
和 
“user”: { 
“href”: "http:// localhost: 9001/data/users/ 132” 


} 
} ] 
} 


ae 玉 1 
“self” : 1{ 

“href” : "http:// localhost: 9001/data/users” 
} 


“profile” : { 
“href”: “http:// localhost: 9001/data/profile/users” 
}, 
"search” : 1 
“href” : “http:// localhost: 9001/data/users; search” 
} 
ls 
"page” : 1 
“size” : 20, 
"totalElemernts” : 1, 
"totalPages” : 1, 
"rumber” : 0 
} 


二 


图 8-4 在 web 模 块 中 查询 的 节点 实体 Usetr 的 REST 资 源 


8.3.3 ”通过 路 由 访问 REST 资 源 

















可 以 使 用 下 面 几 种 方法 通过 Zuul 路 由 代理 方式 来 访问 不 同 服务 中 的 REST 资 源 。 
+ JavaScript; 

: RestTemplate; 

* FeignClient。 


代码 清单 8-17 是 在 web 模 块 中 ,使 





表 。 


代码 清单 8-17 使 用 Query 调 











data 模 块 中 的 REST 资 源 数据 的 一 从 Query 例 子 ， 即 将 














REST 资 源 的 例子 





























户 名 称 作为 参数 ， 调 








data 模 块 的 findByNameContaining 使 





























模糊 查询 的 方法 ， 返 回 符合 条 件 的 用 户 列 





























Var page 
$.ge 


action = function(){ 
t ('/data/users/search/findByNameContaining?name="'+$ ("#name") .val (), 
function (data){ 


Var currentData = data[" embedded"] .users; 


1D); 


fillData (currentData); 





代码 清单 8-18 是 使 


代码 清单 8-18 ”使 用 RestTemplate 调 





















































RestTemplate 的 一 个 例子 ， 即 同样 使 用 用 户 名 称 作 为 参数 ， 调 














REST 资 源 的 实例 





data 模 块 的 findByName 方 法 ， 返 回 一 个 








户 对 象 。 











QService 
public c 


代码 清单 8-19 是 使 


lass UserService { 

@Autowired 

RestTemplate restTemplate; 

public User getUserByName (String name) { 
Map<String, Object> params = new HashMap<>(); 
Params .Put ("name", name); 


User user = restTemplate.getForObject ("http://data/users/search/find-ByName?name={name}", User.class, params); 


return user; 





























代码 清单 8-19 使 用 FeignClient 调 用 REST 资 源 的 实例 





FeignClient 的 一 个 例子 ， 它 使 用 注解 @FeignClient ("data") 的 方式 ， 创 建 一 个 接 





























data 模 块 中 的 findByld 方 法 。 





Q@FeignClient ("data") 

public interface UserClient { 
@RequestMapping (method = RequestMethod.GET, value = "/users/{id}") 
User findById (@RequestParam("id") Long id); 


} 





















































上 面 各 种 调用 方式 ， 可 以 按照 程序 设计 的 要 求 选择 使 用 。 要 使 
@EnableFeignClients， 以 启用 FeignClient 的 功能 。 








8.3.4 ”使 用 断路 器 功能 


断路 器 是 微服 务 中 的 一 个 故障 容错 的 


线路 保护 开关 。 如 同 电路 中 的 负载 保护 开关 一 样 ， 断 路 器 将 在 所 调 





FeignClient， 还 必须 在 工程 的 Maven 依 赖 中 增加 “spring-cloud-starter-feign” 依赖 ， 并 在 工程 的 主 程序 中 增加 一 个 注解 : 

















的 服务 过 载 或 出 现 故障 时 ， 自 动 阻 断 对 服务 的 访问 和 调 

















方法 。 








， 转 而 调用 备 














当 一 个 系统 服务 突然 出 现 故障 或 超载 时 ， 后 面 访问 将 会 陷入 无 限 地 延迟 和 等 待 的 状态 之 中 ， 由 于 请 求 得 不 到 及 时 响应 ， 访 问 者 可 能 会 因此 而 不 断 发 送 请 求 ， 这 将 造成 严重 的 恶性 循环 ， 最 终 导致 整个 系 


统 陷 入 瘫痪 状态 ， 甚 至 会 完全 崩溃 。 使 


代码 清单 8-20 是 一 个 使 





























断路 器 可 以 避免 这 种 情况 发 生 ， 起 到 防 患 于 未 然 的 作 

















了 一 些 虚 假 数 据 ， 以 便 及 时 返回 请 求 结果 。 








代码 清单 8-20 使 





断路 器 的 实例 








断路 器 和 故障 容错 功能 的 实例 。 注 解 @HystrixCommand 为 getUserByName 方 法 配备 一 个 备 上 

















方法 : getUserFallback。 由 getUserFallback 的 实现 代码 可 知 ， 该 方法 只 构造 





Q@Service 
public class UserService { 
@Autowired @LoadBalanced 
RestTemplate restTemplate; 
@HystrixCommand (fallbackMethod = "getUserFallback") 
public User getUserByName (String name) { 


Map<String, Object> params = new HashMap<>(); 
Params .Put ("name", name); 
User user = restTemplate.getForObject ("http://data/users/search/findBy 


Name?name={name}", User.class, params); 


} 


return user; 


private User getUserFallback (String name) { 


User user = new User(); 
user.setName (name + " not find"); 
user.setEmail ("user email"); 
Belong belong = new Belong (); 
Unit unit = new Unit(); 
unit.setName ("unit name"); 
belong.setUnit (unit); 
user.setBelong (belong); 

Owner owner = new Owner () 7 

Role role = new Role(); 
role.setName ("role name"); 

owner .setRole (role); 

List<Owner> owners = new ArrayList<>(); 
owners.add (owner); 

user .setOwners (owners); 

return user; 











8.3.5 ”路 由 器 和 断路 器 测试 














现在 可 以 测试 路 由 器 和 断路 器 的 功能 ， 首 先 启动 实例 工程 的 discovery 模 块 ， 然 后 启动 实例 工程 的 data 模 块 和 web 模 块 ， 在 浏览 器 中 输入 网 址 http://localhost:9001/。 


返回 一 个 用 户 列表 的 界面 ， 这 是 在 web 服 务 中 请 求 了 data 服 务 ， 并 从 中 取得 用 户 列表 数据 的 结果 。 在 界面 中 ， 单 击 查看 ， 将 向 data 服 务 请 求 这 个 用 户 的 详细 资料 ， 如 果 正 常 ， 就 打开 用 户 的 详细 信息 界 
面 。 图 8-5 是 一 个 正常 状态 的 用 户 信息 查看 界面 。 











邮箱 | User@emailcom 








性 | 女 | 


日 期 2016-09-21 18:06:52 














图 8-5 ”服务 正常 时 查看 用 户 信息 的 界面 





如 果 这 时 制造 人 为 的 故障 ， 直 接 关闭 data 服 务 。 现 在 再 在 界面 中 单 击 查 看 ， 它 不 会 陷入 无 限 的 等 待 之 中 ， 而 是 立刻 就 返回 了 ， 只 是 界面 上 的 用 户 信息 是 我 们 上 面 编写 的 一 些 虚假 数据 ， 如 图 8-6 所 示 。 
因为 data 服 务 出 现 了 故障 ， 所 以 对 data 服 务 的 请 求 就 触发 了 断路 器 的 熔断 机 制 。 


[at | 





部 门 unit name 


角色 





图 8-6 ”服务 故障 时 查看 用 户 信 息 的 界面 


8.4 ”使 用 监控 服务 


分 布 式 系统 中 运行 着 很 多 服务 ， 必 须 有 一 个 管理 机 制 或 方法 ， 能 够 一 目 了 然 地 随时 了 解 各 个 服务 的 运行 情况 及 其 健康 指数 ， 以 便 及 时 应 对 已 经 出 现 或 可 能 出 现 的 故障 ， 做 出 相应 的 策略 或 改造 方案 。 使 
用 Spring Cloud 的 监控 服务 ， 可 以 实时 监控 应 用 的 运行 情况 。 


8.4.1 创建 监控 服务 器 





监控 服务 是 Spring Cloud 工 具 集中 的 一 个 功能 组 件 。 要 使 用 监控 服务 的 功能 ， 需 要 创建 一 个 工程 ， 用 来 构建 一 个 监控 服务 器 。 首 先 创建 一 个 Maven 工 程 模块 : hystrix， 在 工程 的 Maven 依 赖 中 引用 如 
代码 清单 8-21 所 示 的 依赖 配置 。 


代码 清单 8-21 ”监控 服务 器 的 Maven 依 赖 配置 





<dependencies> 
<dependency> 


<groupId>org.springframework.cloud</groupId> 
<artifactId>spring-cloud-starter-hystrix-dashboard</artifactId> 


</dependency> 
</dependencies> 











然后 创建 一 个 主 程序 ， 如 代码 清单 8-22 所 示 。 程 序 中 使 








至 


过 


“/hystrix” 位 置 上 。 


代码 清单 8-22 ”监控 服务 主 程序 








注解 @EnableHystrix-Dashboard 启 上 














监控 功能 ， 使 有 

















注解 @Controller 将 该 程序 标注 为 一 个 控制 器 ， 并 设 定 对 根 目录 的 访问 ， 习 





也 
可 





@SpringBootApplication 
QController 
@EnableHystrixDashboard 
public class HystrixApplication{ 
@RequestMapping ("/") 
public String home() { 
return "forward:/hystrix"; 
} 
public static void main (String[] args) 


: 


SpringApplication.run (HystrixApplication.class, args); 


} 





8.4.2 ”监控 服务 器 测试 


现在 可 以 启动 服务 测试 监控 的 效果 。 在 实例 工程 中 启动 discovery、hystrix、data、web 四 个 服务 ， 然 后 在 浏览 器 中 输入 网 址 : http://localhost:7979/。 








打开 如 图 8-7 所 示 的 界面 ， 这 是 监控 服务 器 的 控制 台 。 然 后 ， 监 控 web 服 务 的 运行 情况 ， 在 第 一 行 输入 框 中 输入 URL http://localhost:9001/hystrix.stream,， 








Stream” 按 钮 ， 开 始 对 web 服 务 进行 监控 。 





Hystrix Dashboard 








其 他 输入 框 使 














缺 省 值 ， 再 单 击 “Moniter 





http://hostname:port/turbine/turbine.stream 





Cluster via Turbine (default cluster): http://turbine-hostname :port/turbine. stream 
Cluster via Turbine (custom cluster): http://turbine-hostname:port/turbine. stream?cluster= 
[clusterName] 
Single Wstrir App: http://hystrix-app:port/hystrix. stream 


Title: |Example Hystrx App 


监控 服务 器 首页 


Delay: CoD hs 





这 时 再 按 上 一 节 的 例子 ， 打 开 另 一 个 浏览 器 窗口 








使 














图 8-7 

















web 服 务 ， 在 上 面 做 一 些 操作 ， 即 打开 








户 列表 后 ， 











击 查看 ， 打 开 





中 Circuit 中 显示 了 我 们 请 求 的 服务 data 和 请 求 的 方法 getUserByName 及 其 各 种 性 能 指标 ，Thread Pools 也 显示 了 我 们 请 求 的 





户 详细 信息 ， 等 等 。 返 回 监控 窗口 
民 务 : UserService 的 情况 。 





， 就 可 以 看 到 如 














8-8 所 示 的 监控 界面 。 其 





@ Hystix Monitor 


€ > CC Blocalhost7979/hystrix/monitor?stream=http%3A%2F%2Flocalhost363A9001%2Fhystrix.stream 





Hystrix Stream: http://localhost:9001/hystrix.stream 


data 
0| 0|10. 
6 中 |0.0% 


Host 0.0/s 
Cluster: 0.0/s 
CircuitClosed 


1 90th 27ms 
27rms 99th 27ms 
27ms 99.5th 27ms 


Sort: Alphabetical 


Hosts 
Median 
Mean 


Thread Pools 


Median 775ms 


| Volume | 





UserService 


Host: 0.0/s 
Cluster: 0.0/s 

Max Active 0 
Executfions 0 


再 仿照 上 一 节 的 例子 ， 关 闭 data 服 务 ， 制 造 人 为 的 故障 ， 在 web 服 务 的 窗口 中 单 击 查看 ， 打 开 查 看 


getUserByName 出 现 了 100% 的 故障 。 


ea Hystrik Monitor 


getUserByName 
| 
0 


0 
0 
0 
Host 0.0/s 
Cluster: 0.0/s 
Circuit Closed 


90th 775ms 
99th 775ms 
Mean 775ms 99.5th 775ms 


| 0.0% 
Hosts 


1 


图 8-8 监控 中 web 服 务 的 正常 情况 





细 云 平台 - 用 户 管理 x 1 





用 户 详细 信息 的 界面 ， 然 后 返回 监控 窗口 中 ， 就 可 以 看 到 如 图 





8-9 所 示 的 情况 ， 这 里 看 到 





€ 3 CC Blocalhost:7979/hystrix/monitor?stream=http%3A%2F%2Flocalhost%3A9001%2Fhystrix.stream 





Hystrix Stream: http://localhost:9001/hystrix.stream 
Circuit Sort: Error then Volume | Alphabetical | Volume | Error | Mean | Median | 90 | 99 | 99.5 





data 
0 0 0.0% 
0|0I 


Host 0.0/s 
Cluster: 0.0/s 
Circuit Closed 


1 90ih 0ms 
Oms 939th 0ms 
0ms 995th 0ms 


Sort: Alphabetical 


Hosts 
Median 
Mean 


Thread Pools 


| Volume | 


getUserByName 
0|1 100.0 % 
0|0 
0 
Host 0.1/s 
Cluster: 0.1/s 
Circuit Closed 


Hosts 1 90th 775ms 
Median 775ms 99th 775ms 
Mean 775ms 995th 775ms 





UserService 


Host: 0.1/s 
Cluster: 0.1/s 


0 MaxActive 1 
0 Executions 1 


8.5 ”运行 与 发 布 


图 8-9 ”监控 中 web 服 务 的 异常 情况 


本 章 实例 工程 的 完整 代码 可 以 在 IDEA 中 从 GitHub 直 接 检 出 : https://github.com/chenfromsz/spring-boot-cloud.git。 


检 出 工程 后 ， 在 data 模 块 的 配置 文件 和 测试 的 com.test.data.test.Neo4jConfig 配 置 类 中 配置 好 连接 Neo4j 的 URL、 用 户 名 和 密码 。 在 IDEA 的 Edit Configuration 中 增加 一 个 Maven 打 包 配 置 项 目 ， 
作 目 录 选 择 工程 根 目录 ， 在 命令 行 中 输入 : clean package， 并 将 配置 保存 为 nvn。 运 行 mvn 配 置 项 目 





以 在 命令 行 窗口 使 





用 如 下 指令 : 





， 可 以 对 整个 工程 进行 打包 ， 并 





自动 调 
































王 
data 模 块 的 测试 程序 ， 生 成 测试 数据 。 要 运行 各 个 模块 ， 可 




















java -jar [模块 名 称 -版 本 ] .jar 





也 可 以 在 IDEA 的 Edit Configuration 中 为 各 个 模块 配置 如 下 Maven 指 令 ， 或 者 使 用 命令 行 窗口 切换 到 各 个 模块 工程 所 在 的 目录 中 ， 运 行 下 列 Maven 指 令 ， 启 动 各 个 模块 。 





mvn spring-boot:run 





Oi 在 一 台 机 器 上 运行 以 上 所 有 模块 工程 ， 将 会 消耗 一 定 的 内 存 ， 更 改 各 个 模块 的 配置 ， 将 各 个 模块 发 布 在 不 同 的 机 器 上 运行 ， 可 以 取得 较 好 的 运行 效果 。 


8.6 


小 结 























本 章 使 








开发 工具 











到 以 





集 Spring Cloud， 开 发 和 使 

















的 功能 ， 这 主要 得 益 于 Spring Cloud 强 大 的 封装 功能 。 














现在 我 们 已 经 有 了 一 些 高 可 








的 微服 务 应 











以 及 构建 一 个 高 性 能 的 服务 平台 。 


第 9 章 “构建 高 性 能 的 服务 平台 




















使 用 Spring Cloud 开 发 的 微服 务 ， 其 独立 而 又 相对 隔离 的 特性 ， 与 Docker 的 理念 有 异曲同工 之 妙 ， 
可 用 的 服务 平台 。 

Docker 是 一 个 开源 的 应 用 容器 引擎 ， 可 以 为 应 用 系统 创建 一 个 可 移植 的 独立 
动 很 快 ， 而 且 占 用 资源 极 少 ， 所 以 非常 适合 用 来 发 布 微服 务 。Docker 将 是 未 来 用 来 发 布 服务 的 重要 工 











， 那 么 怎么 使 用 















































本 书 的 实例 工程 都 可 以 非常 容 





构建 一 个 高 性 能 的 服务 平台 ， 
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gl 


使 用 Docker 








使 




















将 使 








那么 什么 是 镜像 和 容器 呢 ? 

















易 地 发 布 在 Docker 上 。 要 将 应 
第 8 章 的 实例 工程 来 进行 发 布 和 测试 。 


了 配置 管理 、 发 现 服务 、 动 态 路 由 、 断 路 器 和 监控 服务 等 功能 。 




















来 搭建 一 个 高 性 能 的 服务 平台 呢 ? 下 一 






































主 的 容器 。 容 器 运行 在 Linux 操 作 系统 上 ， 相 当 于 一 个 虚拟 机 。 但 Docker 相 比 于 虚拟 机 ， 
































使 








却 包含 着 非常 强大 














开发 非常 简单 ， 但 是 开发 的 应 





Spring Cloud 进 行 云 应 

















Docker 来 发 布 本 章 实 例 的 各 个 应 








将 介绍 使 











， 如 何 使 








Docker 实 现 服务 的 负载 均衡 ， 

















所 以 使 








Docker 来 发 布 微服 务 ， 能 够 发 挥 其 更 大 的 优势 ， 并 








可 以 非常 轻易 地 构建 一 个 高 性 能 和 高 


























下 


有 更 加 明显 的 优点 ， 它 不 仅 



























































， 现 在 许多 云 服务 提供 商 已 经 提供 了 对 Docker 的 全 力 支持 。 











发 布 在 Docker 上 ， 首 先 需要 在 Docker 中 创建 应 


Docker 可 以 很 方便 地 创建 和 管理 镜像 ， 以 及 管理 已 经 生成 的 和 正在 运行 的 容器 。 



































。 为 了 演示 使 有 





的 镜像 ， 然 后 就 可 以 使 

















Docker 来 发 布 服务 ， 


镜像 是 一 种 文件 存储 方式 ， 可 以 把 许多 文件 做 成 一 个 镜像 文件 。 例 如 可 以 把 一 个 操作 系统 做 一 个 GHOST 镜像 ， 用 来 重 装 操作 系统 ， 把 一 个 光盘 文件 做 成 一 个 ISO 镜像 ， 等 等 。 


容器 是 镜像 运行 的 一 个 实例 。 运 行 一 个 镜像 ， 就 会 生成 一 个 容器 。 容 器 生成 之 后 ， 就 可 以 在 容器 中 管理 应 


.1 Docker 安 装 


在 Linux 上 安装 Docker， 要 求 是 64 位 系统 ， 并 且 内 核 版 本 需要 3.10 以 上 ， 如 果 使 

















CentOS， 则 使 

















系统 了 。 


























CentOS 7.0 可 符合 要 求 。 可 以 使 用 下 列 指令 查看 Linux 的 内 核 版 本 : 





# uname 一 工 


如 果 安 装 了 CentOS 7.0， 上 述 指令 将 返回 类 似 如 下 的 版 本 信息 : 


3.10.0-123.e17.x86 64 








上 述 版 本 符合 Docker 的 安装 要 求 ， 可 以 使 

















下 列 指令 安装 。 


首先 编写 如 下 内 容 到 docker.repo 中 ， 以 方便 yum 能 找到 Docker 引 警 : 


#tee /etc/yum.repos.d/docker.repo <<-'EOF' 


[dockerrepo] 
name=Docker Repository 





baseurl=https://yum.dockerproject .org/repo/main/centos/7/ 


enabled=1 
gpgcheck=1 


gpgkey=https://yum.dockerproject .org/gpg 
EOF 


# yum update 


# yum install docker-engine 








安装 完成 后 ， 可 以 使 








# service docker start 





下 列 指令 启动 Docker: 











使 








下 列 指令 可 以 查看 Docker 的 版 本 信息 : 





# docker -v 





9.1 


如 果 启 动 成 功 ， 上 述 指令 可 以 看 到 版 本 信息 。 下 列 是 按照 上 面 安装 方法 安装 后 查看 的 版 本 信息 : 


Docker version 1.8.2, build bb472f0/1.8.2 








关于 Docker 的 更 多 安装 信息 ， 可 以 参考 其 官方 网 站 的 说 明 : https://docs.docker.com/engine/installation/。 


.2 ”Docker 常 用 指令 








Docker, 


启动 之 后 ， 就 可 以 使 























Docker 来 创建 和 管理 镜像 了 。 下 列 指令 可 以 测试 运行 一 个 已 经 存在 的 镜像 ， 它 将 会 生成 一 个 容器 并 且 启 动 它 ， 然 后 执行 java-version 指 令 ， 最 后 停止 运行 的 容器 。 





# docker run --name java8 -it java:8 java -version 





运行 上 面 指令 将 启动 一 个 包含 Java ;8 镜像 的 容器 ， 如 果 本 地 没有 这 
器 还 存在 ， 只 是 处 于 停止 状态 。 上 面 指令 将 运行 Java 容 器 并 打印 出 类 似 如 下 所 示 的 版 本 信息 : 





个 Java: 8 镜像 ， 将 会 从 远程 的 镜像 服务 器 中 下 载 一 个 符合 版 本 号 的 镜像 ， 执 行 Java 的 指令 打印 其 版 本 信息 ， 然 后 退出 容器 。 


但 是 容 





openjdk version "1.8.0_66-internal" 
OpenJDK Runtime Environment (build 1.8.0 66-internal-b17) 
OpenJDK 64-Bit Server VM (build 25.66-b17, mixed mode) 

























































































现在 ， 在 系统 中 ， 存 在 一 个 命名 为 Java8 的 镜像 和 一 个 处 于 停止 状态 的 容器 。 可 以 使 用 Docker 的 一 些 指令 来 管理 镜像 和 容器 。 例 如 ， 直 接 运行 这 个 容器 打印 出 Java 的 版 本 信息 。 这 个 容器 没有 什么 
途 ， 可 以 将 它 删除 ， 但 这 个 Java8 镜 像 在 发 布 服务 时 还 会 用 得 到 。 
为 了 使 用 Docker， 需 要 学 习 Docker 的 一 些 指令 。 表 9-1 列 出 了 一 些 主要 指令 的 功能 ， 将 在 下 节 结 合 实际 操作 来 演示 如 何 使 用 这 些 指令 











表 9-1 Docker 主 要 指令 列表 





功能 名 
从 镜像 服务 器 中 查找 镜像 docker search < 镜像 名 . 版 本 > 
拉 取 镜像 docker pull < 镜像 名 : tag> 相当 于 下 载 
创建 镜像 dockerbuild -t< 镜像 名 > <Dockerfile 路 径 >| 需要 编写 Dockerfile 生成 脚本 
查看 所 有 镜像 
删除 镜像 docker 镜像 名 > 


-a stdin 指定 标准 输入 输出 内 
容 类 型 

-d 后 台 运 行 容 器 并 返回 ID ; 

-i 以 交互 模式 运行 容器 ; 


7 M11 


docker run -name 容 顺 名 -d -p 内 部 端口 : 


运行 一 个 新 容器 ep -t 为 wi 重新 分 配 一 个 伪 输 入 
外 部 端口 镜像 名 <. 版 本 > g 
EN Y 终端 ， 通常 与 -i 同时 使 用 ; 
--name ea -个 名 称 ; 


--dns 指定 容 融 使 用 的 DNS 服 
务 器 ， 默 认 和 宿主 一 致 ; 


( 续 ) 


sS 


功能 备注 
--dns-search 指定 容器 DNS 搜 
索 域名 ， 默 认 和 宿主 一 致 ; 
-指定 容 需 的 hostname; 
运行 一 个 新 容器 docker run -name 容 需 名 -d -p 内 部 端口 : | ”-e username 设置 环境 变量 
外 部 端口 镜像 名 <. 版 本 > --env-file=[] 从 指定 文件 读 入 
环境 变量 ; 
--cpuset="0-2" or --cpuset="0, 
E22 
docker un -1 -t --name sonar -d -link mysql:db 
-个 容 融 连接 到 另 一 个 容 姑 “| sonar-server 
sonar 
查看 容器 日 志 docker logs -f< 容器 名 或 ID> 


查看 正在 运行 的 容器 


-a 查看 所 有 容器 ， 
止 运行 的 


已 经 集 
docker ps 人 人 





删除 所 有 容器 docker rm $ (docker ps -a -qd) 
删除 单个 容器 docker rm < 容 吉 名 或 ID> 
停止 一 个 容器 docker stop < 容 毅 名 或 ID> 


| 


9.1.3 ”使 用 Docker 发 布 服务 


docker kill < 容 需 名 或 ID> 
docker start < 容 央 名 或 ID> 





为 了 方便 演示 ， 先 执行 如 下 指令 停 掉 CentOS7.0 的 防火 墙 : 





# Systemct1 stop firewalld.service # 停 止 firewall 
# Systemct1 disable firewalld.service # 禁 止 firewal1 开 机 启动 





























使 通过 Docker 发 布 。 








第 8 章 的 实例 工程 spring-boot-cloud， 可 以 将 各 个 模块 的 应 








首先 ， 将 各 个 模块 的 配置 文件 中 有 localhsot 的 改 为 安装 了 Docker 





肛 务 的 Linux 服 务 器 的 IP 地 址 ， 











因为 在 测试 时 发 现 使 用 localhost 连 接 不 了 发 现 服务 器 。 按 照 Neo4j 数 据 库 服务 器 安装 的 情况 ， 修 改 模块 




















data 中 连接 数据 库 的 参数 ， 按 照 RabbitMQ 服 务 器 安装 的 情况 ， 修 改 模块 config、 模 块 web、 模 块 data 中 连接 RabbitMQ 服 务 器 的 参数 。 





然后 将 整个 工程 





新 打包 ， 这 可 以 在 操作 系统 中 打开 一 个 命令 行 窗 口 ， 将 路 径 切 换 到 工程 根 目录 中 ， 输 入 下 列 的 Maven 指 令 执行 打包 : 





mvn clean package 





打包 完成 后 ， 可 将 jar 文 件 和 各 个 模块 中 创建 镜像 的 脚本 Dockerfile 上 传 到 安装 有 Docker 服 务 的 Linux 服 务 器 上 (实例 工程 的 各 个 模块 已 经 准备 好 了 创建 镜像 的 脚本 ,分别 存放 在 各 个 模块 的 docker 目 录 











下 面 ) 。 可 以 在 Linux 服 务 器 中 为 各 个 模块 创建 一 个 目录 ， 分 别 








来 存放 各 个 模块 的 jar 和 Docke 





| 品 | 便 和 狼 %| 沁 XX ||/root/doud 








rfile 文 件 。 例 如 ， 使 用 如 图 9-1 所 示 的 方式 创建 目录 结构 。 
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emotoWame /| Salye [Momed Avbues] | 


config 
出 data 
出 discovery 


hystrix 
出 web 


图 docker-compose.yml 


图 9-1 


Dockerfile 是 创建 镜像 的 一 个 脚本 文件 ， 它 的 内 容 如 代码 清单 9-1 所 示 ， 这 是 config 模 块 创建 镜像 的 脚本 ， 脚 本 首先 导入 java: 8 的 镜像 ， 最 后 使 





不 多 ， 只 是 其 中 的 jar 文 件 和 EXPOSE 设 置 不 同 而 已 。 


代码 清单 9-1 创建 镜像 脚本 


FROM java:8 

VOLUME /tmp 

ADD config-1.0-SNAPSHOT .jar app.jar 

RUN bash -c 'touch /app.jar' 

EXPOSE 8888 

ENTRYPOINT ["java","-Djava.security.egd=file:/dev/./urandom","-jar","/app.jar"] 


Folder 
Folder 
Folder 
Folder 
Folder 
370 YML 文件 





2016/06/01 14:5. drwxr-xr... 
2016/06/02 10:4... 
2016/06/01 14:3... 
2016/05/31 17:2... 
2016/06/01 11:4... 


2016/06/01 12:0... 


drwxr-xr... 
drwxr-xr... 
drwxr-xr... 
drwxr-xr... 
-rw-r--r-- 


发 布 服 务 的 目录 结构 


























Java 来 运行 jar。 其 他 各 个 模块 的 Dockerfile 跟 这 个 差 





现在 以 config 模 块 为 例 ， 说 明 如 何 创 建 镜像 。 首 先 切换 到 上 面 上 传 的 config 模 块 文件 的 所 在 目录 ， 然 后 执行 下 列 指令 ,使 























Java: 8 的 支持 ， 指 令 中 最 后 的 “.” 表 示 使 





录 的 脚本 文件 。 








当 痛 








i 














当前 目录 的 Dockerfile 脚 本 创建 一 个 名 称 为 config 的 镜像 ， 镜 像 已 包含 








#docker build -t config . 





执行 上 面 指令 的 输出 结果 如 下 : 





Sending build context to Docker daemon 38.57 MB 
Step 0 : FROM java:8 

---> de4al3c84f53 

Step 1 : VOLUME /tmp 

---> Using cache 

---> 78fdb4381981 

Step 2 : ADD config-1.0-SNAPSHOT.jar app.jar 
---> lcaac40c3c4b 
Removing intermediate container b2ddba948d17 
Step 3 : RUN bash -c 'touch /app.jar' 

---> Running in f032d980aa40 

-> 2d7145438750 

Removing intermediate container f032dq980aa40 
Step 4 : EXPOSE 8888 

---> Running in e3c025ecb44f 

---> 10f0835f36b4 

Removing intermediate container e3c025ecb44f 
Step 5 : ENTRYPOINT java -Djava.security.egd=file:/dev/./urandom -jar /app.jar 
---> Running in cb3982402715 

---> 46dc046aa4e3 

Removing intermediate container cb3982402715 
Successfully built 46dc046aa4e3 














从 输出 结果 中 可 以 看 到 命令 执行 的 步骤 ， 最 后 完成 的 镜像 ID 为 46dc046aa4e3。 使 











下 列 指令 可 以 查看 已 经 创建 的 和 存在 的 镜像 : 





#docker images 


从 执行 结果 可 以 看 出 刚才 创建 的 镜像 的 名 称 、 版 本 、1ID、 创 建 时 间 和 镜像 大 小 等 信息 ， 由 了 





F 没 有 指定 版 本 ， 所 以 默认 生成 为 latest， 如 下 所 示 : 





TAG 
latest 


MAGE ID CREATED VIRTUAL SIZE 
46dc046aa4e3 About a minute ago 


REPOSITORY 


config 719 MB 








现在 























可 以 使 用 下 列 指令 来 运行 这 个 镜像 ， 这 个 指令 设 定 服务 在 后 台 运行 ， 并 将 容器 的 内 部 端口 8888 映 射 到 外 部 端口 8888， 容 器 的 名 字 也 设 定 为 config。 





#docker run --name config -d -p 8888:8888 config 

















只 有 在 第 一 次 运行 服务 时 ， 才 需要 使 用 上 面 的 指令 ， 因 为 它 同时 会 生成 一 个 容器 ， 所 以 以 后 需要 运行 服务 时 ， 只 要 直接 启动 容器 即 可 。 




















使 








下 列 指令 可 以 查看 正在 运行 的 容器 : 





#docker ps 











要 查看 正在 运行 的 容器 中 服务 的 运行 情况 ， 可 以 使 用 下 列 指令 来 查看 正在 运行 的 服务 的 控制 台 输出 日 志 。 例 如 ， 下 列 指令 可 以 查看 config 容 器 的 输出 日 志 : 








#docker logs -config 























由 于 还 没有 运行 发 现 服务 器 discovery， 从 日 志 中 可 以 看 出 输出 了 一 些 错误 信息 。 现 在 先 使 用 如 下 指令 停止 这 个 容器 : 




















#docker stop config 





要 启 











动 一 个 已 经 存在 的 容器 ， 例 如 启动 config 容 器 ， 可 以 使 用 如 下 指令 : 











#docker start config 











使 
便 的 工具 








上 面 创建 镜像 的 方法 ， 将 实例 工程 中 的 其 他 几 个 模块 ， 按 照 模块 的 名 称 来 命名 镜像 ， 各 自 创 建 一 个 镜像 。 实 例 工程 中 每 个 模块 都 已 经 提供 了 镜像 生成 脚本 Dockerfile。 在 下 一 节 将 介绍 使 
来 管理 这 些 镜像 及 其 相关 的 容器 和 服务 。 

















所 有 镜像 创建 完成 之 后 ， 使 用 查看 镜像 指令 可 以 列 出 已 经 创建 的 镜像 ， 类 似 于 如 下 所 示 的 镜像 列表 : 


























更 加 简 





REPOSITORY TAG IMAGE ID CREATED VIRTUAL SIZE 

web latest da3c3b3da46b 28 seconds ago 721.9 MB 
hystrix latest 2ccelf533f£11 About a minute ago 685.4 MB 
discovery latest cbfa35ccadb9 5 minutes ago 718 MB 
data latest 9ddea4fdladc 6 minutes ago 825.9 MB 
config latest 46dc046aa4e3 15 hours ago 719 MB 





9.2 ”创建 和 管理 一 个 高 性 能 的 服务 体系 





























使 



























































Docker 发 布 服务 之 后 ， 可 以 使 用 其 他 一 些 服务 管理 工具 来 构建 高 性 能 和 高 可 用 的 服务 平台 。 上 面 创建 的 镜像 可 以 很 方便 地 使 用 docker-compose 来 管理 。 





docker-compose 工 具 是 一 个 Docker 容 器 管理 工具 集 ， 可 以 很 方便 地 用 来 创建 和 重建 容器 、 执 行 启动 和 停止 容器 等 管理 操作 ， 以 及 查看 整个 服务 体系 的 运行 情况 和 输出 
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四 
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工具 ， 只 要 一 条 指令 就 能 启动 整个 分 布 式 服务 体系 。 


9.2.1 安装 qdocker-compose 














首先 ， 安 装 docker-compose 工 具 ， 使 用 下 列 指令 下 载 已 经 编译 的 docker-compose: 





docker-compose 





#curl -L https://github.com/docker/compose/releases/download/1.7.1/docker-compose 
-uname -s -uname -m’ > /usr/local/bin/docker-compose 





























执行 指令 将 下 载 docker-compose 可 执行 文件 ， 并 保存 在 “/userlocalbin” 中 。 这 样 ， 可 以 使 用 下 列 指令 ， 赋 予 它 为 任何 用 户 可 执行 : 

















# chmod +x /usr/local/bin/docker-compose 














这 就 完成 了 安装 ， 现 在 可 以 使 用 docker-compose 指 令 查看 它 的 版 本 号 : 








# docker-compose --version 





如 果 安 装 成 功 ， 将 打印 出 类 似 如 下 的 信息 : 





docker-compose 1.7.1 





9.2.2 docker-compose 常 用 指令 








使 








下 列 指令 可 以 查看 docker-compose 的 帮助 说 明 : 





#docker-compose -Ph 





表 9-2 列 出 了 docker-compose 主 要 指令 的 功能 。 


表 9-2 docker-compose 主 要 指令 列 表 


功能 
创建 或 重建 、 启 动容 器 
删除 停止 运行 的 所 有 容 需 
启动 所 有 容 央 
停止 所 有 容器 
列 出 运行 的 容器 列表 
查看 正在 运行 的 容器 的 输出 日 志 
设置 同一 个 服务 运行 的 容器 个 数 
在 一 个 服务 上 执行 一 个 命令 


9.2.3 ”使 用 docker-compose 管 理 服务 





为 了 使 














部 端口 ，links 





这 个 docker-compose 模 板 将 一 些 高 可 


个 高 性 能 的 


代码 清 








来 指定 一 个 服务 需 

















服务 平台 。 


单 9-2 docker-compose.yml 文 件 内 容 


hystrix: 
image: hystrix 


rts: 
"7979:7979" 


links: 

- discovery 
discovery: 

image: discovery 


Or 


ts: 
"8761:8761" 


config: 
image: config 


ports: 
— "8888:8888" 
links: 


- discovery 


data: 


image: data 
links: 

- discovery 
-Config 


web: 


image: web 


por 


ts: 
"9001:9001" 


links: 
- discovery 
- config 


-rr 
DC 
4> 


scale 


UN 


docker-compose 将 上 一 节 创建 的 所 有 镜像 ， 构 建成 一 个 服务 体系 ， 需 要 编写 一 个 docker-compose 模 板 ， 如 代码 清单 9-2 所 示 。 其 
依赖 的 其 他 服务 列表 。 注 意 ， 服 务 data 没 有 指定 外 部 端 














， 它 只 供 内 部 调用 。 























备注 


-d 在 后 台 运 行 


[service]=[number] 














中 image 





来 指定 镜像 的 名 称 ，ports 设 定 容器 的 内 部 和 外 


将 这 个 模板 保存 为 docker-compose.yml 文 件 ， 并 上 传 到 Linux 服 务 器 上 ， 然 后 在 文件 所 在 位 置 ， 执 行 下 列 指令 ， 创 建 如 模板 所 设置 的 容器 ， 并 启动 其 相应 的 服务 。 


的 微服 务 ， 通 过 links 连 接 成 为 一 个 整体 ， 这 样 就 可 以 通过 docker-compose 统 一 管理 ， 并 且 可 以 在 运行 的 过 程 中 ， 动 态 设 定 服务 的 负载 均衡 实例 ， 从 而 建立 一 





#docker-compose up 








在 控制 台中 ， 可 以 看 到 输出 日 志 。 从 日 志 中 可 以 看 出 ，docker-compose 按 照 模 板 一 个 一 个 地 创建 镜像 的 容器 ， 然 后 开始 启动 服务 。 


上 面 指令 只 有 在 未 创建 容器 ， 即 第 一 次 运行 时 ， 才 需要 这 样 执行 。 当 从 控制 台中 退出 时 ， 会 同时 停止 已 经 启动 的 服务 ， 除 非 上 面 指令 加 上 “-d” 参 数 。 生 成 容器 之 后 ， 就 可 以 使 F 


服务 体系 : 




















如 下 指令 


来 启动 整 


个 





#docker-compose start 


在 服务 运行 过 程 中 ， 如 果 启 动 脚本 中 未 设 定 服务 的 外 部 端口 





#docker-compose scale data=2 


， 如 服务 data， 可 以 使 

















如 下 命令 指定 服务 的 个 数 ， 这 个 指令 将 会 在 线 增加 一 个 容器 ， 并 且 将 其 自动 纳入 负载 均衡 的 管理 中 。 





负载 均 

















衡 是 Spring Cloud 工 . 








“ 简单 轮 询 规则 ; 


“ 加 权 响 应 时 间 规 则 ; 


“区域 感知 轮 询 规 则 ; 


“ 随机 规则 。 


Spring Cloud 默 认 启 上 

















代码 清单 9-3 ”负载 均衡 配置 
ribbon: 
eureka: 


enabled: true 


集中 一 个 组 件 Ribbon 的 功能 ， 这 是 一 个 内 置 了 可 插 拔 、 可 定制 的 负载 均衡 组 件 ， 它 主 


Ribbon 的 负载 均衡 功能 ， 也 可 以 在 工程 的 配置 中 增加 如 代码 清单 9-3 所 示 的 配 








具备 如 下 负载 均衡 规则 : 














， 明 确 指定 启 








Ribbon 的 功能 。 




















现在 按照 第 8 章 的 测试 方法 来 测试 各 个 服务 的 运行 情况 。 注 意 ， 为 了 完成 测试 ，Linux 服 务 器 至 少 需要 4GB 以 上 的 内 存 。 图 9-2 是 发 现 服务 器 的 控制 台 ， 它 展示 了 发 现 服务 器 中 服务 的 注册 情况 。 其 中 IP 地 
址 192.168.1.221 是 我 们 使 用 的 Linux 服 务 器 的 IP， 同 时 可 以 看 到 data 应 用 已 经 注册 了 两 个 服务 ， 而 监控 服务 hystrix 因 为 没有 在 发 现 服务 器 中 注册 ， 所 以 这 里 看 不 到 。 
























































Replicas 


192.168.1.221 


nstances currently registered with Eureka 


Application AMIIS Availability Zones Status 


CONFIG n/a (1) (1) UP (1) - c85938feQdac:config:8888 


DATA n/a (2) (2) UP (2) - ecfb6b82b1d9:data:9000 , 8ca22bd08aac:data:9000 


UP{1) - 4a0db0d5b23fweb:9001 


Name 
total-avail-memory 
environment 


num-of-cpus 





current-memory-usage 152mb (41%) 


server-uptime 00:36 
registered-replicas http://192.168.1.221:8761/eureka/ 


unavailable-replicas http://192.168.1.221:8761/eurekal/, 





available-replicas 


图 9-2 ”服务 注册 情况 




















对 于 两 个 data 服 务 的 负载 均衡 配置 ， 系 统 只 是 采 
一 秒 左右 ， 系 统 自动 调整 以 适应 只 有 一 个 data 服 务 的 

















了 默认 的 简单 轮 询 负载 均衡 规则 ， 当 人 为 停止 其 中 一 个 data 服 务 时 ， 如 果 不 断 地 调 
情况 ， 这 是 Spring Cloud 的 自动 修复 功能 所 起 的 作用 ， 如 图 9-3 所 示 。 











getUserByName 方 法 ， 会 有 一 瞬间 出 现 50% 故 障 的 情况 ， 再 过 











[ 

















ircuit Sort: Error then Volume | Alphabetical | Volume | Error | Mean | Median | 90 | 99 | 99.5 


Ciuster: 0.0/s 
Hosts 1 


Circuit Closed 
90th) 395ms 

Median 395ms 
Mean 208ms 995th 395ms 


data 


0|10.0 % 
0 


getUserByName 
1| 1|50.0% 
0|0 

0 

Host 0.2/s 
Cluster: 0.2/s 
Circuit Closed 


Hosts 1 90th 68ms 
Median 50ms 99th 71ms 
Mean 45ms 995th 71ms 


read Pools Sort: Alphabetical 


UserService 


Host: 0.2/s 
Cluster: 0.2/s 


99th 395ms 


| Yolume | 








使 














Active 


DO 


Queued 

















能 ， 并 且 具 有 





这 个 实例 的 高 可 





























例 可 以 使 





项 





屋 服 务 : 





服务 体系 结 
提供 的 功能 ， 


0 
0 


Max Active 
Executions 








docker-compose， 很 轻易 地 他 


构 简 
轻易 





建 了 一 个 高 可 














和 高 性 能 的 服务 平台 ， 
自我 修复 故障 的 能 力 。 当 然 ， 这 些 功能 和 性 能 优势 与 Spring Cloud 的 支持 是 分 不 














到 如 图 














9-4 所 示 。 其 中 ， 配 置 服务 器 、 监 控 服务 器 和 发 现 
也 实现 动态 路 由 、 断 路 器 和 负载 均衡 等 服务 。 底 层 的 数据 服务 实例 就 是 由 数据 服务 使 


1 
2 





图 9-3 ”监控 服务 器 中 显示 出 现 故 障 的 情况 




















的 。 








它 不 但 容易 管理 ， 而 且 服 务 启动 速度 很 快 ， 更 加 难能可贵 的 是 ， 


肛 务 器 处 于 整个 服务 体系 的 顶层 之 中 ， 为 数据 服务 和 应 


它 能 够 动态 调整 负载 均衡 配置 ， 实 现 服务 的 在 线 可 插 拨 功 

















实例 提供 项 端的 管理 服务 功能 。 而 数据 服务 和 应 















































项 





屋 服 务 提供 的 负载 均衡 功能 而 实现 的 几 个 负载 均衡 的 运行 实例 。 


发 现 服务 器 


数据 服务 


负载 均衡 | | 发 现 服 务 发 现 服 务 


数据 服务 实例 1| | 数据 服务 实例 2| | 数据 服务 实例 3 











图 9-4 ”微服 务 高 可 用 服务 体系 结构 








9.3 ”使 用 Docker 的 其 他 负载 均衡 实施 方法 



































Docker 还 可 以 跟 其 他 工具 配合 使 用 ， 配 置 各 种 负载 均衡 服务 ， 搭 建 高 性 能 的 服务 平台 。 例 如 Docker 跟 Nginx、Haproxy、Kubernetes 等 工具 配合 使 用 ， 都 能 设计 出 高 性 能 和 高 可 用 的 负载 均衡 服务 。 
不 过 这 些 内 容 已 经 超过 了 本 书 的 范围 ， 下 面 只 是 简单 地 介绍 ， 有 兴趣 的 读者 可 以 查找 相关 的 资料 进行 深入 研究 。 











9.3.1 使 用 Nginx 与 Docker 构 建 负载 均衡 服务 


最 简单 的 莫 过 于 使 用 Nginx 来 作为 负载 均衡 服务 ， 连 接 分 布 于 不 同 机 器 上 的 由 Docker 发 布 的 服务 。 如 下 代码 是 一 个 非常 简单 的 Nginx 负 载 均衡 配置 。 








server { 
listen 80; 
server name 192.168.1.10; 
location /{ 
Proxy_pass http://blance; 


upstream blance{ 
server 192.168.1.11; 
Server 192.168.1.12; 
} 






































这 个 简单 的 配置 是 将 Nginx 安 装 在 一 台 机 器 上 ， 对 外 提供 服务 ， 它 使 用 负载 均衡 的 机 制 ， 将 实际 使 用 的 服务 分 布 在 其 他 两 台 机 器 上 。 











9.3.2 ”阿里 云 的 负载 均衡 设计 实例 


看 看 在 使 用 阿里 云 的 负载 均衡 设计 中 ， 使 用 Nginx 和 Docker 配 置 的 一 个 可 以 动态 扩容 的 负载 均衡 的 样 例 ， 这 也 许 能 给 我 们 一 些 参考 和 启示 。 











如 下 代码 使 用 docker-compose 的 模板 ， 配 置 了 两 个 Nginx 和 两 个 Tomcat， 并 且 每 个 Tomcat 都 运行 两 个 容器 。 





nginx: 
image: 'nginx:latest' 
labels: 
aliyun.routing.port 80: 'http://ngtomcat' 
aliyun.scale: '2' 
ports: 
- ,80" 
links: 
— 'tomcatl:tomcatl1' 
— 'tomcat2:tomcat2"' 
restart: always 
extra hosts: 
— "tomcat1.ir:123.56.80.151" 
- "tomcat2.1ir:182.92,.204.43" 
tomcat1: 
environment: 
— LANG=C.UTF-8 
— CATALINA HOME=/usr/local/tomcat 
— TOMCAT MAJOR=8 
image: 'tomcat:latest' 
labels: 
aliyun.scale: '2' 
aliyun.routing.port 8080: 'http://tomcat.ir' 
ports: 
— "8080' 
restart: always 
tomcat2: 
environment: 
— LANG=C .UTF-8 
— CATALINA HOME=/usr/local/tomcat 
— TOMCAT MAJOR=8 
image: 'tomcat:latest' 
labels: 
aliyun.scale: '2"' 
aliyun.routing.port 8080: 'http://tomcat.ir 
ports: 
- "8080' 
restart: always 


1 





而 它 的 Nginx 的 配置 如 下 代码 所 示 : 





upstream tomcat.ir { 
server tomcat.ir.1; 
server tomcat.ir.2; 
} 
server { 
listen 80; 
server name tomcat.ir; 
index index.html index.htm index.php; 
access 1og /var/log/nginx/access.1og; 
location / { 
proxy pass http://tomcat.ir; 
} 


} 








(上 面 资料 来 源 : https://yq.aliyun.com/articles/6816#3) 





9.4 小 结 




































































本 章 介绍 使 用 Docker 来 发 布 分 布 式 应 用 系统 ， 演 示 了 使 用 一 个 更 加 轻 量 级 的 容器 管理 工具 docker-compose 来 构建 一 个 高 性 能 和 高 可 用 的 服务 平台 。 在 演示 中 ， 我 们 发 现 Docker 的 运行 速度 非常 流 
畅 ， 这 是 虚拟 机 系统 无 法 比拟 的 ， 使 用 Docker 来 发 布 和 管理 服务 将 是 未 来 的 发 展 趋 势 。 此 外 ，Docker 还 可 以 跟 其 他 负载 均衡 工具 配合 使 用 ， 以 搭建 一 个 高 性 能 和 高 可 用 的 服务 平台 。 






























































在 后 续 的 章节 中 ， 将 分 析 Spring Boot 的 一 些 核心 功能 的 源 代码 ， 以 加 深 对 Spring Boot 的 理解 ， 还 能 帮助 我 们 为 更 好 地 使 用 Spring Boot 框 架 铺 平 道路 。 

















第 三 部 分 “核心 技术 源 代码 分 析 


“ 第 10 章 Spring Boot 自 动 配置 实现 原理 

: 第 11 章 ”Spring Boot 数 据 访问 实现 原理 

“ 第 12 章 ”微服 务 核心 技术 实现 原理 

这 一 部 分 将 简要 分 析 Spring Boot 的 一 些 核 心 功能 的 源 代码 及 其 实现 原理 ， 加 深 对 Spring Boot 的 理解 和 学 会 如 何 更 好 地 使 用 Spring Boot: 

第 10 章 分 析 Spring Boot 应 用 中 程序 入 口 的 源 代码 、Spring Boot 自 动 配置 的 实现 原理 ， 同 时 利用 自动 配置 的 原理 ， 演 示 如 何在 主 程序 中 通过 更 改 加 载 配置 的 方式 ， 提 升 应 用 的 性 能 。 
第 11 章 简要 分 析 Spring Boot 访 问 数据 库 的 源 代码 和 实现 原理 ， 并 在 探索 其 实现 原理 的 过 程 中 ， 扩 展 访 问 数据 库 的 功能 。 


第 12 章 简要 分 析 微 服务 中 配置 管理 、 发 现 服务 和 负载 均衡 服务 的 源 代码 和 实现 原理 ， 同 时 使 用 一 个 简单 的 例子 ， 形 象 地 说 明了 微服 务 中 使 用 分 布 式 消息 的 实现 原理 。 


第 10 章 Spring Boot 自 动 配置 实现 原理 









































通过 前 面 章节 的 学 习 ， 我 们 掌握 了 使 用 Spring Boot 框 架 进行 实际 应 用 开发 的 方法 。 在 使 用 Spring Boot 的 过 程 中 ， 我 们 时 常会 为 一 些 看 似 简单 ， 但 实际 上 蕴藏 了 强大 功能 的 实现 而 惊 呼 ， 下 面 就 让 我 们 
来 揭 开 它 的 神秘 面纱 ， 做 到 知 其 然 ， 进 而 知 其 所 以 然 。 在 认识 Spring Boot 的 实现 原理 之 后 ， 我 们 在 使 用 某 些 功能 时 ， 就 能 够 做 到 心中 有 数 ， 从 而 更 好 地 使 用 它 。 

































































10.1 Spring Boot 主 程序 的 功能 














代码 清单 10-1 是 Spring Boot 应 用 的 一 个 典型 主 程序 ， 它 看 起 来 非常 简单 ， 使 用 了 一 个 同样 看 起 来 非常 简单 的 注解 @SpringBootApplication， 并 用 一 个 非常 普通 的 main 方 法 运行 SpringApplication 的 
run 方 法 。 这 个 简单 的 主 程序 将 会 加 载 一 个 应 用 所 需 的 所 有 资源 和 配置 ， 最 后 启动 一 个 应 用 实例 。 





















































代码 清单 10-1 Spring Boot 应 用 主 程序 





@SpringBootApplication 
public class Application { 
public static void main (String[] args) { 
SpringApplication.run (Application.class, args); 
} 





10.1.1 SpringApplication 的 run 方 法 














Spring Boot 的 主 程序 有 什么 神奇 的 地 方 呢 ? 可 以 从 SpringApplication 的 run 方 法 说 起 ， 这 是 应 用 主 程序 开始 运行 的 方法 ， 它 的 源 代码 如 代码 清单 10-2 所 示 。 这 个 方法 让 我 们 能 够 看 清楚 Spring Boot 的 
一 切 秘密 所 在 ， 它 首先 开启 一 个 SpringApplicationRun-Listeners 监 听 器 ， 然 后 创建 一 个 应 用 上 下 文 ConfigurableApplicationContext， 通 过 这 个 上 下 文 加 载 应 用 所 需 的 类 和 各 种 环境 配置 等 ， 最 后 启动 一 
个 应 用 实例 。 



































代码 清单 10-2 SpringApplication 中 run 的 源 代码 





package org.springframework.boot; 
http://www.hzcourse.com/resource/readBook?path=/openresources/teach ebook/uncompressed/15925/0EBPS/Text/. .http://www.hzcourse.com/resource/readBook?path=/openresources/teach ek 
public class SpringApplication { 
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public ConfigurableApplicationContext run(Stringhttp://www.hzcourse.com/resource/readBook?path=/openresources/teach ebook/uncompressed/15925/0EBPS/Text/... args) { 
StopWatch stopWatch = new StopWatch(); 
stopWatch. start (); 
ConfigurableApplicationContext context = null; 
this.configureHeadlessProperty(); 
SpringApplicationRunListeners listeners = this.getRunListeners (args); 
listeners.started(); 


try { 
DefaultApplicationArguments ex = newDefaultApplicationArguments (args); 
context = this.createAndRefreshContext (listeners, ex); 
this.afterRefresh (context, (ApplicationArguments)ex); 
listeners.finished(context, (Throwable)null); 
stopWatch. stop(); 
if(this.logStartupInfo) { 
(new StartupInfoLogger (this.mainApplicationClass)) .logStarted 
(this.getApplicationLog(), stopWatch); 
} 


return context; 
} catch (Throwable var6) { 
this .handleRunFailure (context, listeners, var6); 
throw new IllegalStateException (var6); 
} 
} 
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注 











0 果 你 使 用 过 Spring 框 架 ， 就 会 更 加 清楚 这 种 加 载 应 用 的 实现 机 制 。 在 Spring 中 ， 加 载 一 个 应 用 ， 主 要 是 通过 一 些 复杂 的 配置 来 实现 的 。 这 样 看 来 ，Spring Boot 只 不 过 是 把 这 些 本 来 由 程序 员 做 的 工 
有 先 帮 我 们 实现 罢了 。 
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由 | 





10.1.2 ”创建 应 用 上 下 文 




















一 个 应 用 能 够 正常 运行 起 来 ， 需 要 一 些 环境 变量 、 各 种 资源 和 一 些 相关 配置 等 ， 从 创建 应 用 上 下 文 ConfigurableApplicationContext 的 源 代码 中 ， 我 们 可 以 看 到 这 种 实现 机 制 ， 如 代码 清单 10-3 所 示 。 
其 中 ，this.load (context，sources.toArray (new Object[sources.size () ]) ) 将 调用 BeanDefinitionLoader 来 加 载 应 用 定义 的 和 需要 的 类 及 各 种 资源 。 





















































代码 清单 10-3 ”创建 应 用 上 下 文 一 一 createAndRefreshContext 的 源 代码 





package org.springframework.boot; 
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public class SpringApplication { 
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private ConfigurableApplicationContext createAndRefreshContext (SpringApp 
licationRunListeners listeners, ApplicationArguments applicationArguments) { 
ConfigurableEnvironment environment = this.getOrCreateEnvironment (); 
this.configureEnvironment (environment, applicationArguments.getSource 
Args ()); 
4 listeners.environmentPrepared (environment); 
if (this.isWebEnvironment (environment) && !this.webEnvironment) { 
environment = this.convertToStandardEnvironment (environment); 


i 
if(this.bannerMode != Mode.OFF) { 
this.printBanner (environment); 
} 
ConfigurableApplicationContext context = this.createApplicationContext (); 
context .setEnvironment (environment); 
this.postProcessApplicationContext (context); 
this.applyInitializers (context); 
listeners.contextPrepared (context); 
if (this.logsStartupInfo) { 
this.1ogStartupInfo (context .getParent () == null); 
this.1ogStartupProfileInfo (context); 
} 
context .getBeanFactory() .registerSingleton ("springApplicationArguments", 
applicationArguments); 
Set sources = this.getSources(); 
Assert .notEmpty (sources, "Sources must not be empty"); 
this.load (context, sources.toArray (new Object [sources.size()]))7 
listeners.contextLoaded (context); 
this.refresh (context); 
if (this.registerShutdownHook) { 
try { 
context .registerShutdownHook (); 
} catch (AccessControlException var7) { 
i 
} 


return context; 
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} 





10.1.3 ”自动 加 载 




















在 BeanDefinitionLoader 中 ， 有 一 个 load (Class<? >source) 方法 用 来 加 载 类 定义 ， 如 代码 清单 10-4 所 示 。 这 里 的 source 就 是 代码 清单 10-1 中 定义 的 Application.class。 在 程序 中 通过 
isComponent 检 查 是 否 存在 注解 ， 如 果 有 注解 ， 则 调用 注解 相关 的 类 定义 。 这 样 注解 @springBootApplication 将 被 调用 ， 它 不 但 会 导入 一 系列 自动 配置 的 类 ， 还 会 加 载 应 用 中 一 些 自 定义 的 类 。 















































代码 清单 10-4 _ BeanDefinitionLoader 中 load (Class<? >source) 源 代码 





Package org.springframework.boot; 
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class BeanDefinitionLoader { 
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Private int load(Class<?> source) { 
if (this.isGroovyPresent () && BeanDefinitionLoader.GroovyBeanDefinition 
Source.class.isAssignableFrom(source)) { 
BeanDefinitionLoader.GroovyBeanDefinitionSource loader = (Bean 
DefinitionLoader .GroovyBeanDefinitionSource)BeanUtils.instantiateClass (source, BeanDefinitionLoader.GroovyBeanDefinitionSource.class); 
this.load (loader); 
} 
if(this.isComponent (source)) { 
this.annotatedReader.register (new Class[] {source}); 
return 1; 
} else { 
return 0; 


} 
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private boolean isComponent (Class<?> type) { 


return AnnotationUtils.findAnnotation (type, Component.class) != null? 
true: !type.getName () matches (".*\\$_.*closure.*") && !type.isAnonymousClass() && type.getConstructors() != null && type.getConstructors().length != 0; 
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} 
































从 以 上 分 析 可 知 ， 一 个 简单 的 Spring Boot 主 程序 ， 通 过 运行 一 个 run 方 法 ， 就 将 引发 一 系列 复杂 的 内 部 调用 和 加 载 过 程 ， 从 而 初始 化 一 个 应 用 所 需 的 配置 、 环 境 、 资 源 及 各 种 类 定义 等 。 特 别 是 导入 了 
一 系列 自动 配置 类 ， 实 现 了 强大 的 自动 配置 功能 ， 这 是 Spring Boot 框 架 最 引 人 注 目的 地 方 。 




















10.2 Spring Boot 自 动 配置 原理 


所 有 的 自动 配置 都 是 从 注解 @SpringBootApplication 引 入 的 ， 我 们 来 看 看 它 的 源 代 码 ， 就 一 切 都 明 


























白 了 。 如 代码 清单 10-5 所 示 ， 注解 @SpringBootApplication 








其 实 又 包含 了 三 个 非常 重要 的 注解 ， 即 




















@Configuration、@EnableAutoConfiguration 和 @ComponentScan， 其 中 注解 @EnableAutoConfiguration 就 是 启 | 














动 配置 的 ， 并 将 导入 一 些 











动 配置 的 类 定义 ， 注 解 @ComponentScan 将 扫描 




















和 加 载 应 








中 的 一 些 自 定义 的 类 。 





代码 清单 10-5 SpringBootApplication 源 代码 


package org.springframework.boot.autoconfigure; 
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@Target ({ElementType.TYPE}) 

@Retention (RetentionPolicy.RUNTIME) 

@Documented 

@Inherited 

@Configuration 

@EnableAutoConfiguration 

@ComponentScan 

public Qinterface SpringBootApplication { 
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} 


10.2.1 ”自动 配置 的 即 插 即 用 原理 


. -http://www.hzcourse.com/resource/readBook?path=/openresources/teac 


























EnableAutoConfiguration 最 终 会 导入 一 个 自动 配置 的 类 列表 ， 如 代码 清单 10-6 所 示 。 列 表 中 的 








动 配置 类 很 多 ， 这 些 配 











类 中 大 都 将 被 导入 ， 并 处 于 备 








状态 中 ， 同 电器 中 准备 了 一 些 揪 模 一 























样 ， 即 实现 了 即 插 即 用 的 原理 。 这 样 ， 当 项 目 中 引入 了 相关 的 包 时 ， 相 关 的 功能 将 被 启 
关 Redis 的 配置 信息 。 














代码 清单 10-6 ”自动 配置 类 部 分 列表 


。 例 如 在 项 目的 Maven 管 理 中 配置 了 Redis 的 引用 ， 那 么 Redis 的 功能 将 被 启用 ， 





























启动 应 用 ， 程 序 将 尝试 读 取 有 

















# Auto Configure 

org.springframework. 
org.springframework. 
org.springframework. 
org.springframework. 
org.springframework. 
org.springframework. 
org.springframework. 
org.springframework. 
org.springframework. 
org.springframework. 
org.springframework. 
org.springframework. 
org.springframework. 
org.springframework. 
org.springframework. 
org.springframework. 
org.springframework. 
org.springframework. 
org.springframework. 
org.springframework. 
org.springframework. 
org.springframework. 


boot .autoconfigure. 
boot .autoconfigure. 


EnableAutoConfiguration=\ 
admin.SpringApplicationAdminJmxAutoConfiguration,\ 

boot .autoconfigure.aop.AopAutoConfiguration, \ 

boot .autoconfigure.amqp.RabbitAutoConfiguration, \ 

boot .autoconfigure.MessageSourceAutoConfiguration, \ 

boot .autoconfigure.PropertyPlaceholderAutoConfiguration, \ 

boot .autoconfigure.batch.BatchAutoConfiguration, \ 

boot .autoconfigure.cache.CacheAutoConfiguration,\ 

boot .autoconfigure.cassandra.CassandraAutoConfiguration,\ 

boot .autoconfigure.cloud.CloudAutoConfiguration, \ 

boot .autoconfigure.context .ConfigurationPropertiesAutoConfiguration, \ 

boot .autoconfigure.dao.PersistenceExceptionTranslationAutoConfiguration,\ 

boot .autoconfigure.data.cassandra.CassandraDataAutoConfiguration, \ 

boot .autoconfigure.data.cassandra.CassandraRepositoriesAutoConfiguration, \ 

boot .autoconfigure.data.elasticsearch.ElasticsearchAutoConfiguration, \ 

boot .autoconfigure.data.elasticsearch.ElasticsearchDataAutoConfiguration, \ 

boot .autoconfigure.data.elasticsearch.ElasticsearchRepositoriesAutoConfiguration, \ 
boot .autoconfigure.data.jpa.JpaRepositoriesAutoConfiguration, \ 

boot .autoconfigure.data.mongo.MongoDataAutoConfiguration, \ 

boot .autoconfigure.data.mongo.MongoRepositoriesAutoConfiguration,\ 

boot .autoconfigure.data.solr.SolrRepositoriesAutoConfiguration, \ 

boot .autoconfigure.data. redis.RedisAutoConfiguration, \ 





10.2.2 ”自动 配置 的 约定 优先 原理 





























在 自动 配置 中 加 载 一 个 类 的 配置 时 ， 首 先 读 取 项 目 中 的 配置 ， 只 有 项 目 中 没有 相关 配置 才 启 




















配置 的 默认 值 ， 这 就 是 自动 配置 的 约定 优先 原理 。 代 码 清单 10-7 是 Thymeleaf 配 置 类 的 源 代码 ， 如 果 在 项 























目的 配置 文件 中 没有 配置 spring.thymeleaf 的 相关 参数 ， 就 使 
配置 。 











代码 清单 10-7 Thymeleaf 配 置 源 代 码 


Thymeleaf 的 默认 配置 ， 默 认 配置 将 使 用 templates 作 为 HTML 文 件 的 存放 路 径 。 在 前 











章节 使 











四 


Thymeleaf 的 实例 中 ， 就 是 使 用 了 这 个 默认 














Package org.springframework.boot.autoconfigure.thymeleaf; 
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@ConfigurationProperties ("spring.thymeleaf") 
public class ThymeleafProperties { 
private static final Charset DEFAULT ENCODING = Charset.forName ("UTF-8"); 
private static final MimeType DEFAULT CONTENT TYPE = MimeType.valueOf ("text/ 
html™); 
public static final String DEFAULT PREFIX = "classpath:/templates/™"; 
public static final String DEFAULT SUFFIX = ".html"; 
Private boolean checkTemplateLocation = true; 
private String prefix = "classpath:/templates/"™; 
private String suffix = ".html"; 
private String mode = "HTML5"7 
private Charset encoding; 
private MimeType contentType; 
Private boolean cache; 
Private Integer templateResolverOrder; 
private String[] viewNames; 
private String[] excludedViewNames; 
private boolean enabled; 
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10.3 ”提升 应 用 的 性 能 














动 配置 在 给 我 们 提供 很 大 便利 的 同时 ， 难 免 会 有 一 些 副 作 | 








， 即 增加 了 应 F 








Spring Boot 的 
些 技巧 进行 优化 。 























10.3.1 ”更 改 加 载 配 置 的 方式 




















启动 的 时 间 、 一 些 内 存 和 CPU 的 消耗 等 。 如 果 应 



































对 性 能 要 求 很 高 ， 就 可 以 根据 自动 配置 的 原理 ， 使 




























































































































































































如 果 能 清楚 一 个 应 用 需要 哪些 配置 ， 就 能 够 更 改 加 载 配置 的 方式 ， 即 不 使 用 自动 配置 ， 而 是 改 为 指定 加 载 一 些 应 用 所 需 的 配置 。 

为 了 弄 清楚 一 个 应 用 需要 加 载 哪些 配置 ， 可 以 使 用 Maven 调 试 的 方式 来 启动 一 个 应 用 ， 然 后 从 控制 台 的 输出 日 志 中 ， 确 定 哪 些 是 这 个 应 用 需要 加 载 的 配置 类 。 下 面 使 用 第 1 章 中 简单 的 实例 项 目 来 说 明 
这 种 操作 。 

首先 ， 在 IDEA 的 Edit Configuration 中 增加 一 个 Maven 配 置 ， 工 作 路 径 选择 项 目 根 目录 ， 在 命令 行 中 输入 : spring-boot: run-Ddebug， 并 把 配置 保存 为 debug， 如 图 10-1 所 示 。 











Bl Run/Debug Configurai 


以 Debug 方 式 运行 debug 配 置 ， 启 动 应 


类 Spring Boot 


Defaults 








图 10-1 使 用 Maven 调 试 的 配置 




















， 然 后 在 控制 台中 找 出 Positive matches 的 类 ， 如 代码 清单 10-8 所 示 。Positive matches 就 是 这 个 应 




















代码 清单 10-8 ”加 载 自动 配置 的 Positive matches 类 列表 











所 需 加 载 的 一 些 配置 类 。 








AUTO-CONFIGURATION REPORT 








Positive matches 








DispatcherServletAutoConfiguration matched 


DispatcherServlet (OnClassCondition) 


- @ConditionalonClass classes found: org.springframework.web.servlet. 


- found web application StandardServletEnvironment (OnWebApplication 

















Condition)，……' 
通过 整理 后 ， 得 出 这 个 应 加 载 的 配置 类 列表 ， 如 代码 清单 10-9 所 示 。 











代码 清单 10-9 ”整理 后 的 Positive matches 类 列表 





Positive matches: 
DispatcherServletAutoConfiguration matched 
EmbeddedServletContainerAutoConfiguration matched 
GenericCacheConfiguration matched 
HttpEncodingAutoConfiguration matched 
HttpMessageConvertersAutoConfiguration matched 


JacksonAutoConfiguration matched 


JmxAutoConfiguration matched 
MultipartAutoConfiguration matched 
NoOpCacheConfiguration matched 


RedisCacheConfiguration matched 


ServerPropertiesAutoConfiguration matched 


SimpleCacheConfiguration matched 


ThymeleafAutoConfiguration matched 


WebMvcAutoConfiguration matched 


WebSocketAutoConfiguration matched 





根据 这 个 配置 类 加 载 列 表 ， 就 可 以 在 主 程序 中 使 用 注解 @Configuration 来 代 蔡 注解 @SpringBootApplication， 并 用 注解 @Import 指 定 需要 加 载 的 配置 类 ， 经 过 更 改 后 的 应 用 主 程序 如 代码 清和 


所 示 。 


























代码 清单 10-10 ” 主 程序 中 指定 加 载 的 配置 类 





和 E10-10 








@Configuration 
@Import ({ 
DispatcherServletAutoConfiguration.class, 
EmbeddedServletContainerAutoConfiguration.class, 
ErrorMvcAutoConfiguration.class, 
HttpEncodingAutoConfiguration.class, 
HttpMessageConvertersAutoConfiguration.class, 
JacksonAutoConfiguration.class, 


}) 


JmxAutoConfiguration.class, 


MultipartAutoConfiguration.class, 
ServerPropertiesAutoConfiguration.class, 
PropertyPlaceholderAutoConfiguration.class, 
ThymeleafAutoConfiguration.class, 
WebMvcAutoConfiguration.class, 
WebSocketAutoConfiguration.class 


@RestController 

public class Application { 
QRequestMapping ("/") 
String home () { 


return "hello"; 


public static void main(String[] args) { 
SpringApplication.run (Application.class, args); 





ND 







































































另外 ,为 了 提高 应 用 的 性 能 ,还 可 以 更 改 默认 使 用 的 Tomcat 揪 件 ， 换 成 更 加 小 巧 的 Jetty 插 件 。 例 如 ， 代 码 清单 10-11 是 在 工程 的 Maven 配 置 中 排除 引用 默认 的 Tomcat， 转 而 引用 Jetty 的 依赖 。 

















代码 清单 10-11 使 用 Jetty 的 Maven 配 置 


<dependencies> 
<dependency> 
<groupId>org.springframework.boot</groupId> 
<artifactId>spring-boot-starter-web</artifactId> 
<exclusions> 
<exclusion> 
<groupId>org.springframework.boot</groupId> 
<artifactId>spring-boot-starter-tomcat</artifactId> 
</exclusion> 
</exclusions> 
</dependency> 
<dependency> 
<groupId>org.springframework.boot</groupId> 
<artifactId>spring-boot-starter-jetty</artifactId> 
</dependency> 
</dependencies> 














通过 上 面 一 些 改造 之 后 ， 可 以 对 照 测试 一 下 ， 看 看 效果 如 何 。 打 开 IDEA 的 Edit Configuration 对 话 框 ， 增 加 一 个 Application 配 置 ， 工 作 目录 选择 工程 根 目录 ， 并 选择 工程 主 程序 ， 然 后 在 VM options 





中 输入 如 下 配置 参数 : 





-Dcom. sun.management .jmxremote -Dcom.sun.management.Jjmxremote.Port="9004" 
-Dcom. sun.management .jmxremote.authenticate="false" 
-Dcom. sun.management .jmxremote.ssl="false" 



































这 样 配 置 的 目的 ， 是 让 我 们 可 以 使 用 JConsole 来 观察 应 用 运行 的 各 项 性 能 指标 。 配 置 完成 后 的 效果 如 图 10-2 所 示 。 








Name: hello 
Configuration 


Main class: spring example.Applc 
顺 Spring Boot 


OF Defaults nage mxremote.authenticate="false" -Dcom.sun.management 


Program arguments 


Use ahternath 


Enable captu 


Before launch: Mal 





图 10-2 启动 应 用 测试 配置 














对 比 改造 前 后 的 两 种 情况 ， 改 造 后 应 用 的 启动 时 间 有 所 加 快 。 











改造 前 启动 应 用 的 时 间 如 下 所 示 : 














Started Application in 3.171 seconds (UVM running for 4.941) 











改造 后 启动 应 用 的 时 间 如 下 : 





Started Application in 2.957 seconds (UVM running for 5.869) 









































应 用 启动 后 ， 使 用 JConsole 新 建 一 个 连接 ， 可 以 观察 应 用 运行 的 各 项 性 能 指标 。 根 据 上 面 配置 的 参数 ， 可 以 在 远程 进程 中 输入 localhost: 9004， 然 后 单 击 “ 连 接 ” 按 钮 ， 如 图 10-3 所 示 。 

















s. jetbhrains., jps. cmdine. Launcher D:/Prog... 


rE. Jetbrains. 1 dea. Haver. surer. RemoteMNeawe. .. 16500 
sun, tools. jeonsole, JConsele 


加 J 远程 堪 程 但 ) : 


localhost :900d| | 


用 待 : <hostnasey :port》 吕 gervice: jmr: 《protocoly: Eapy 


pw [| nw:[ | 








图 10-3 JConsole 新 建 连接 





























改造 前 后 的 两 种 运行 情况 对 照 如 图 10-4 所 示 。 图 中 各 项 指标 处 于 0 的 位 置 是 中 间 停 止 时 的 状态 ， 从 图 中 可 以 看 出 ， 改 造 后 内 存 的 使 用 量 明显 减少 了 ，CPU 的 占用 也 有 所 改善 ， 加 载 的 类 减少 了 一 点 ， 
































不 是 很 明显 。 从 总 体 上 来 说 ， 性 能 是 有 所 改善 了 。 


并 





时 间 范 围 伺 ): 





“ 挫 内 存 使 用 量 
200 Mb 


17:02 
已 提交 : 


17:03 
110.6 Nb 


17:04 
最 大 : 926.9 肥 





-线程 


活动 : 


17:02 
21 


17:03 
幢 值 : 23 


17:04 
总 计 : 各 








17:02 
5.516 


17:03 
已 和 郑 载 : 0 





已 扣 载 : 


17:04 
总 计 : 





5,516 





FCPV 占用 率 
4% 


17:02 17:03 
CPU 占用 率 : 0. 1% 








105 小结 

















主 程序 的 内 部 实现 的 一 些 源 代码 ， 及 其 功能 强大 的 


图 10-4 改造 前 后 的 两 














本 章 分 析 了 Spring Boot 应 上 
实现 。 这 就 不 难 理解 ， 为 什么 使 














因 





Spring Boot 可 以 那么 简单 ， 这 是 























基于 对 Spring Boot 的 深入 了 解 ， 特 别 是 认识 
帮助 我 们 加 深 对 Spring Boot 的 理解 。 


动 配置 的 实现 原 

















图 之后， 就 可 以 改造 一 个 应 | 








中 运行 情况 对 照 图 












































通过 前 面 章 节 的 应 用 实例 ， 我 们 也 知道 ， 在 Spring Boot 中 使 
在 使 用 数据 库 方面 的 一 些 实现 原理 ， 看 看 它 又 有 什么 神奇 之 处 。 

















第 11 章 Spring Boot 数 据 访问 实现 原理 


Spring Boot 的 数据 库 管理 功能 非常 强大 ， 它 到 底 可 以 支持 哪些 数据 库 ， 访 问 这 些 数据 库 的 功能 又 是 如 何 实现 的 ， 这 些 功 能 有 没有 欠缺 或 者 需要 扩 


问题 感 兴趣 ， 那 么 可 以 开始 这 一 章 的 学 习 。 





11.1 连接 数据 源 的 源 代码 分 析 
要 使 用 数据 库 ， 首 先 必须 与 数据 库 服务 器 建立 连接 。 对 于 关系 型 数 

















数据 库 也 是 非常 简单 的 ， 那 么 Spring Boot 在 使 








的 方式 来 建立 连接 。 代 码 清单 11-1 是 JDBC 的 一 些 连接 参数 的 定义 ， 使 








代码 清单 11-1 ”数据 源 配置 参数 定义 源 代码 








居 库 ，Spring Boot 连 接 数据 源 一 般 都 采 上 
关系 型 数据 库 时 ，Spring Boot 的 


加 载 配置 的 方式 ， 从 而 达到 提高 性 能 的 目的 。 虽然 这 种 改造 的 人 有 





动 配置 的 实现 原理 ， 使 我 们 认识 了 神奇 的 Spring Boot 的 内 部 实现 机 制 ， 在 看 似 简单 的 调 
为 它 把 一 些 复杂 的 实现 ， 都 事先 帮 有 我 们 做 好 了 。 


























数据 库 方 














3 





， 其 内 部 实现 又 是 怎样 一 个 引 人 入 





























动 配置 将 尝试 


VF 



































中 ， 其 实 包含 着 复杂 的 内 部 





并 不 是 特别 明显 ， 但 是 不 管 怎样 ， 至 少 能 





展 的 地 方 ， 如 果 需 要 扩 


竹 的 工程 呢 ? 下 一 章 将 分 析 Spring Boot 





展 应 该 如 何 改进 ”如 果 你 对 这 些 





JDBC (Java Data Base Connectivity) 的 方式 来 实现 。 


的 配置 文件 中 读 取 这 些 配置 项 。 























他 类 型 的 数 








独立 





居 库 却 使 用 各 自 











QConfigurationProperties ( 
prefix = "spring.datasource" 


public class DataSourceProperties implements BeanClassLoaderAware, EnvironmentAware, InitializingBean { 


public static final String PREFIX = "spring.datasource™; 
private ClassLoader classLoader; 

Private Environment environment; 

private String name = "testdb"; 

private Class<? extends DataSource> type; 

private String driverClassName; 

Private String url; 

private String username; 

private String password; 

private String jndiName; 

Private boolean initialize = true; 

private String platform = "al1"7 

private String schema; 

private String data; 

Private boolean continueOnError = false; 

private String separator = ";"; 

private Charset sqlScriptEncoding; 

Private EmbeddedDatabaseConnection embeddedDatabaseConnection; 
private DataSourceProperties.Xa xa; 


11.1.1 数据 源 类 型 和 驱动 

















JDBC 连 接 数 据 源 必 须 指定 数据 源 类 型 和 数据 库 驱动 程序 ， 在 程序 中 用 driver-ClassName 来 指定 数据 库 驱 动 程序 的 名 称 ， 例 如 使 用 MySQL 的 驱动 程序 是 com.mysqljdbc.Driver， 而 数据 源 的 类 型 默认 使 
org.apache.tomcat.jdbc.pool.DataSource， 如 代码 清单 11-2 所 示 。 












































代码 清单 11-2” JDBC 的 DataSourceBuilder 源 代码 片段 





package org.springframework.boot.autoconfigure.jdbc; 
public class DataSourceBuilder { 
Private static final String[] DATA SOURCE TYPE NAMES = new String[]{"org.apache. 
tomcat .jdbc.pool.DataSource", "com.zaxxer.hikari.HikariDataSource", "org.apache.commons.dbcp.BasicDataSource", "org.apache.commons.dbcp2.BasicDataSource"}; 
private Class<? extends DataSource> type; 
Private ClassLoader classLoader; 
Private Map<String, String> properties = new HashMap(); 
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public Class<? extends DataSource> findType() { 
if(this.type != null) { 
return this.type; 
} else { 
String[] varl = DATA SOURCE TYPE NAMES; 
int var2 = varl.length; 
int var3 = 0; 
while (var3 < var2) { 
String name = varl [var3]; 
try { 
return ClassUtils.forName (name, this.classLoader); 
} catch (Exception var6) { 
++var3; 
} 
} 


return null; 



























































数据 源 的 类 型 可 以 通过 配置 更 改 ， 这 一 功能 给 我 们 使 用 其 他 数据 源 提 供 了 很 大 的 便利 。 例 如 在 第 4 章 中 使 用 Druid 数 据 源 时 ， 就 是 使 用 如 下 的 配置 来 指定 数据 源 类 型 ， 即 代码 中 的 type 设 定 为 


com.alibaba.druid.pool.DruidDataSource。 





spring: 
datasource: 
type: com.alibaba.druid.pool.DruidDataSource 
driver-class-name: com.mysql.jdbc.Driver 





11.1.2 ”支持 的 数据 库 种 类 


Spring Boot 默 认 几 乎 可 以 支持 现 有 的 所 有 数据 库 ， 代 码 清单 11-3 是 DatabaseDriver 定 义 一 个 枚 举 类 的 源 代码 ， 从 这 个 数据 库 驱 动 的 定义 列表 中 可 以 看 出 ， 它 默认 支持 的 数据 库 种 类 。 但 这 并 不 是 说 ， 
这 个 列表 中 没有 列 出 的 数据 库 就 不 支持 了 ， 只 是 可 以 采用 其 他 方式 来 建立 连接 而 已 。 例 如 ，Redis、MongoDB、Neo4j 等 数据 库 都 使 用 了 各 自 独特 的 方式 来 建立 连接 。 


















































代码 清单 11-3” 枚 举 类 DatabaseDriver 源 代码 片段 








package org.springframework.boot.autoconfigure.jdbc;: 
enum DatabaseDriver { 
UNKNOWN ( (String)nul1)， 
DERBY ("org.apache.derby.jdqbc.EmbeddedqDriver")， 
H2 ("org.h2.Driver", "org.h2.jdbcx.JdbcDataSource"), 
HSQLDB ("org.hsqldb.jdbc.JDBCDriver", "org.hsqldb.jdbc.pool.JDBCXADataSource"), 
SQLITE ("org.sqlite.JDBC"), 
MYSQL ("com.mysql .jdbc.Driver", "com.mysql.jdbc.jdbc2.optional.MysqlXAData 
Source"), 
MARIADB ("org .mariadb.jdbc.Driver", "org.mariadb.jdbc.MySQLDataSource"), 
GOOGLE ("com.google.appengine.api.rdbms.AppEngineDriver"), 
ORACLE ("oracle.jdbc.OracleDriver", "oracle.jdbc.xa.client.OracleXADataSource"), 
POSTGRESQL ("org.postgresql .Driver", "org.postgresql .xa.PGXADataSource"), 
JTDS ("net .sourceforge.jtds.jdbc.Driver"), 
SQLSERVER ("com.microsoft.sqlserver.jdbc.SQLServerDriver", "com.microsoft. 
sqlserver.jdbc.SQLServerXADataSource"), 
DB2 ("com.ibm.db2.jcc.DB2Driver", "com.ibm.db2.jcc.DB2xADataSource"), 
AS400 ("com.ibm.as400.access .AS400JDBCDriver", "com.ibm.as400.access.AS4 
00JDBCXADataSource™); 
private final String driverClassName; 
private final String xaDataSourceClassName; 
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11.1.3 ”与 数据 库 服务 器 建立 连接 

































































最 终 ， 不 管 使 用 哪 一 种 数据 库 ， 与 数据 库 服务 器 建立 连接 大 体 上 都 会 用 到 三 个 参数 ， 即 数据 库 链 接地 址 、 名 和 密码 。 下 面 我 们 来 看 一 看 ，Spring Boot 在 使 用 一 个 新 型 的 数据 库 Neo4j 时 是 怎么 建立 
连接 的 。Neo4j 是 一 个 NoSQL 数 据 库 ， 它 不 能 使 用 IDBC 的 方式 来 建立 连接 ， 所 以 由 spring-data-neo4j 提 供 连 接 数据 库 服务 器 的 方法 。 使 用 Neo4j 数 据 库 ， 一 般 使 用 如 代码 清单 11-4 所 示 的 方法 来 连接 数据 
库 服务 器 ， 即 通过 继承 Neo4jConfiguration， 重 载 neo4jServer 方 法 来 实现 。 



























































代码 清单 11-4 ”连接 Neo4j 的 配置 类 定义 





@Configuration 
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public class Neo4jConfig extends Neo4jConfiguration { 
QOverride 
public Neo4jServer neo4jServer() { 
return new RemoteServer ("http://192.168.1.221:7474", "neo4j", "12345678"); 
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上 面 的 代码 最 终 将 调用 超 类 Neo4jConfiguration 中 的 constructSession 方 法 ， 使 用 提供 的 链接 地 址 、 用 户 名 和 密码 ， 与 数据 库 服务 器 建立 连接 ， 如 代码 清单 11-5 所 示 。 





























代码 清单 11-5 ”Neo4j 连 接 服 务 器 部 分 源 代码 





@Configuration 
public abstract class Neo4jConfiguration { 
private Session constructSession (Neo4jServer server) 
return server.url() != null && server.username() != null && server. 
password() != null?this.getSessionFactory() .openSession (server.url(), server. 
username (), server.password()):this.getSessionFactory () .openSession (server.url ()); 





11.2 ”数据 存 取 功 能 实现 原理 











与 数据 库 服务 器 建立 连接 之 后 ， 就 可 以 对 数据 库 执行 一 些 存 取 操作 ， 对 数据 库 实现 管理 的 功能 。 数 据 存 取 的 操作 大 体 上 都 包含 两 个 方面 的 内 容 ， 即 实体 建 模 和 持久 化 。 不 管 是 关系 型 数据 库 ， 还 是 
NoSQL 数 据 库 ， 都 遵循 这 一 设计 规范 。 

















11.2.1 ”实体 建 模 源 代码 分 析 








实体 建 模 的 原理 简单 地 说 ， 即 将 Java 的 普通 对 象 和 关系 映射 为 数据 库 表 及 其 相关 的 关系 。 而 这 种 映射 在 Spring Boot 中 ， 主 要 是 通过 注解 的 方式 来 实现 。 几 种 数据 库 中 主要 的 注解 定义 如 表 11-1 所 示 。 





表 11-1 实体 建 模 主 要 注解 定义 


数据 库 主要 注解 
@Entity 

@Table 

@Id 
GeneratedValue 
@ManyToOne 
@ManyToMany 
@JoinTable 
@JoinColumn 


MySQL 


@Document 
@Id 


MongoDB 
@Indexed 





@Language 


数据 库 主要 注解 
@NodeEntity 
@GraphId 
Neo4] @Relationship 


@Index 





(QProperty 








这 种 映射 机 制 是 双向 的 ， 当 向 数据 库存 入 数据 时 ， 是 将 Java 对 象 映 射 为 数据 库 对 象 ， 而 从 数据 库 取 出 数据 时 ， 却 将 数据 库 中 的 数据 还 原 为 Java 对 象 。 
例如 对 于 Neo4j 来 说 ， 在 实体 建 模 中 的 主要 注解 @NodeEntity 的 定义 如 代码 清单 11-6 所 示 。 在 一 个 类 定义 中 使 用 这 个 注解 ， 表 示 这 个 类 定义 就 是 一 个 节点 实体 的 建 模 。 


代码 清单 11-6 _@NodeEntity 源 代码 





Package org.neo4j .ogm.annotation; 
import java.lang.annotation.ElementType; 
import java.lang.annotation.Inherited; 
import java.lang.annotation.Retention; 
import java.lang.annotation.RetentionPolicy; 
import java.lang.annotation.Target; 
@Retention (RetentionPolicy.RUNTIME) 
@Target ({ElementType.TYPE}) 
@Inherited 
public Qinterface NodeEntity { 

String CLASS = "org.neo4j .ogm.annotation.NodeEntity"; 


String LABEL = "label"; 
String label() default ""7 











[出 


形 。 代 码 清单 11-7 是 这 种 映射 的 部 分 实现 代码 。 它 的 实现 原理 是 ， 将 实体 对 象 转化 为 数据 库 可 以 识别 的 查询 语 




















Neo4j 是 一 个 图 形 数据 库 ， 所 以 程序 中 的 实体 对 象 要 存 入 数据 库 时 ， 将 被 映射 为 数据 库 
句 ， 实 现 对象 到 数据 的 转换 。 





代码 清单 11-7 ”实体 对 象 映 射 为 数据 库 


网 








形 的 部 分 源 代 码 








Package org.neo4j .ogm.mapper; 
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public class EntityGraphMapper implements EntityToGraphMapper { 加 人 
public CypherContext map (Object entity, int horizon) { 
if(entity == null) { 
throw new NullPointerException("Cannot map null object"); 
} else { 
SinglestatementCypherCompiler compiler = new SingleStatementCypher 


Compiler(); 
Iterator i$ = this.mappingContext .mappedRelationships () .iterator (); 
while(i$.hasNext()) { 
MappedRelationship mappedRelationship = (MappedRelationship) 
i$.next () 7 
this.logger.debug ("context-init: (${})-[:{}]->(${})", new Object 
[] {Long.valueOf (mappedRelationship.getStartNodeId()), mappedRelationship.getRelationshipType(), Long.valueOf (mappedRelationship.getEndNodeId())}); 


compiler.context () .registerRelationship (mappedRelationship); 
} 
this.logger.debug ("context initialised with {} relationships", Integer.valueOf (this.mappingContext .mappedRelationships() .size())); 
if(this.isRelationshipEntity (entity)) { 
entity = this.entityAccessStrategy.getStartNodeReader (this.metaData.classInfo (entity)) .read (entity); 
if(entity == null) { 
throw new RuntimeException("@StartNode of relationship entity may not be nul1"); 
i 
} 
this.mapEntity (entity, horizon, compiler); 
this.deleteObsoleteRelationships (compiler); 
return compiler.compile(); 


} 


} 
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当 从 Neo4j 数 据 库 中 读 取 数据 时 ，Neo4j 将 数据 库 中 的 图 形 还 原 为 实体 对 象 。 代 码 清单 11-8 是 实现 这 种 功能 的 部 分 源 代 码 ， 即 将 从 数据 库 中 查询 得 到 的 数据 集合 转化 为 实体 对 象 ， 实 现 从 数据 到 对 象 的 
转换 。 











代码 清单 11-8 数据库 中 图 形 还 原 为 实体 对 象 的 部 分 源 代码 





package org.neo4j .ogm.mapper; 
http://www.hzcourse.com/resource/readBook?path=/openresources/teach ebook/uncompressed/15925/0EBPS/Text/. .http://www.hzcourse.com/resource/readBook?path=/openresources/teach ek 
public class GraphEntityMapper implements GraphToEntityMapper<GraphModel> { 站 
Private void mapNodes (GraphModel graphModel, List<Long> nodeIds) { 
Iterator i$ = graphModel .getNodes () .iterator(); 
while(i$.hasNext()) { 
NodeModel node = (NodeModel)i$ .next(); 
Object entity = this.mappingContext .getNodeEntity (node.getId()); 
try { 
if(entity == null) { 
entity = this.mappingContext.registerNodeEntity (this.entity 
Factory.newObject (node), node.getId()); 
} 
this.setIdentity (entity, node.getId()); 
this.setProperties (node, entity); 
this.mappingContext .remember (entity); 
nodeIds.add (node .getId()); 
} catch (BaseClassNotFoundException var7) { 
this.logger.debug (var7 .getMessage () ) 
} 
i 
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11.2.2 ”持久 化 实现 原理 


























关系 型 数据 库 都 使 用 了 JPA 的 一 套 执行 标准 ， 它 结合 使 用 Hibernate 实 现 了 实体 的 持久 化 。 后 续 的 数据 库 管理 设计 都 遵循 了 JPA 这 一 个 标准 规范 ， 提 供 相 同 的 访问 数据 库 的 APl。 图 11-1 是 JPA、 
MongoDB、Neo4j 三 种 不 同 的 资源 库 接 口 定义 的 相同 的 继承 关系 。 























这 就 不 难 理解 ， 为 什么 在 Spring Boot 中 使 用 数据 库 ， 对 于 不 同 种 类 的 数据 库 ， 几 乎 都 可 以 使 用 相同 的 方法 来 访问 。 但 是 ， 上 


Repository 


CrudRepository 


PagingAndSortingRepository 


JpaRepository MongoRepository GraphR epository 
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11-1 数据 库 资 源 库 接口 的 继承 关系 















































不 同 数据 库 的 资源 库 接口 定义 虽然 有 相同 的 继承 关系 ， 它 们 的 实现 方法 却 











回 














是 不 同 的 ，JPA 由 SimpleJpaRepository 实 现 了 JpaRepository， 如 代码 清单 11-9 所 示 。 


代码 清单 11-9 JPA 数 据 库 持久 化 源 代码 片段 





package org.springframework.data.jpa.repository.support; 
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@Repository 

@Transactional ( 


) 


readOonly = true 


public class SimpleJpaRepository<T, ID extends Serializable> implements JpaRepository<T, ID>, JpaSpecificationExecutor<T> { 


private static final String ID MUST NOT BE NULL = "The given id must not be null!"; 
private final JpaEntityInformation<T, ?> entityInformation; 

private final EntityManager em; 

private final PersistenceProvider provider; 

private CrudMethodMetadata metadata; 

public SimpleJpaRepository (JpaEntityInformation<T, ?> entityInformation, Entity 


Manager entityManager) { 


Assert .notNull (entityInformation); 

Assert .notNull (entityManager); 

this.entityInformation = entityInformation; 

this.em = entityManager; 

this.provider = PersistenceProvider.fromEntityManager (entityManager); 


public T findone (ID id) { 
Assert .notNull (id, "The given id must not be null!"); 
Class domainType = this.getDomainClass(); 
if(this.metadata == null) { 
return this.em.find (domainType, id); 
} else { 
LockModeType type = this.metadata.getLockModeType (); 
Map hints = this.getQueryHints (); 
return type == null?this.em.find(domainType, id, hints) :this.em. 


find (domainType, id, type, hints); 


} 
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而 对 于 Neo4j 来 说 ， 它 使 用 GraphRepositorylImpl 实 现 了 GraphRepository， 如 代码 清单 11-10 所 示 。 


代码 清单 11-10 ”Neo4j 数 据 库 持久 化 源 代码 片段 





Package org.sPringframework.data.neo4j .repository7 
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@Repository 


public class GraphRepositoryImpl<T> implements GraphRepository<T> { 


private static final int DEFAULT QUERY DEPTH = 1; 

private final Class<T> clazz; 本 加 

Private final Session session; 

public GraphRepositoryImpl (Class<T> clazz, Session session) { 
this.clazz = clazz; 
this.session = session; 
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public T findone (Long id) { 


return this.session.load(this.clazz, id); 
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11.3 ”扩展 数据 存 取 的 功能 


往 
































数据 库 是 应 用 系统 最 基本 的 功能 需求 ， 同 时 也 是 最 频繁 和 最 复杂 的 功能 需求 。Spring Boot 始 终 以 使 用 简单 为 基准 ,提供 了 一 套 以 JPA 的 标准 规范 来 设计 的 数据 存 取 方法 ,虽然 功能 相当 强大 ， 但 往 








不 能 适合 一 些 复杂 的 功能 需求 ， 这 就 需要 对 数据 存 取 的 功能 做 一 些 扩展 。 了 解 Spring Boot 使 用 数据 库 的 实现 原理 之 后 ， 要 扩展 数据 存 取 的 功能 就 比较 容易 了 。 








11.3.1 扩展 JPA 功 能 











根据 数据 库 持久 化 的 原理 ， 可 以 扩展 数据 存 取 的 功能 ， 例 如 在 第 4 章 中 ， 实 现 了 扩展 JPA 的 功能 ， 如 代码 清单 11-11 所 示 。 数 据 库 持久 化 的 接口 实现 类 Expandjpa-RepositoryImpl， 它 继承 了 
SimpleJpaRepository 的 实现 ， 扩 展 了 JPA 访 问 数据 库 的 功能 。 

















代码 清单 11-11 扩展 JPA 实 现 类 





public class ExpandJpaRepositoryImpl<T, ID extends Serializable> extends Simple 
JpaRepository<T, ID> implements ExpandJpaRepository<T,ID> { 
private final EntityManager entityManager; 
private final JpaEntityInformation<T, ?> entityInformationy 
public ExpandJpaRepositoryImpl (JpaEntityIinformation<T, ?> entityInformation, 
EntityManager entityManager) { 
super (entityInformation, entityManager); 
this.entityManager = entityManager; 
this.entityInformation = entityInformation; 
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11.3.2 ”扩展 Neo4j 功 能 








遵循 JPA 标 准 规范 来 设计 ， 这 对 于 新 型 的 Neo4j 数 据 库 来 说 是 一 个 挑战 。 在 JPA 中 ， 可 以 使 用 如 下 定义 来 执行 一 个 分 页 的 查询 : 














QQuery("select 七 from User 七 where 七 .name like :name") 
Page<User> findByName (GParam("name") String name, Pageable pageRequest); 





但 是 这 种 方法 对 于 Neo4j 来 说 ， 却 会 导致 严重 的 错误 ， 如 下 定义 是 无 法 被 正常 执行 的 : 





QQuery ("MATCH (m:Movie) WHERE m.name =~ ('(?i).*'+{name}+'.*') RETURN m") 
Page<Movie> findByName (@Param("name") String name, Pageable pageable); 























所 以 为 了 实现 这 种 分 页 查询 ， 需 要 编写 一 个 全 局 扩展 类 来 实现 ， 如 代码 清单 11-12 所 示 ， 它 调用 了 Neo4j 的 底层 实现 方法 org.neo4j.ogm.session.Session 来 执行 分 页 查询 。 











代码 清单 11-12 ”Neo4j 分 页 查询 服务 类 





@Service 
public class PagesService<T> { 
@Autowired 
Private Session session; 
public Page<T> findAll (Class<T> clazz, Pageable pageable, Filters filters){ 
Collection data = this.session.]loadAll (clazz, filters, convert (pageable. 
getSort () ) new Pagination (pageable.getPageNumber(), pageable.getPageSize()), 1); 
return updatePage (pageable, new ArrayList (data)); 
} 
private Page<T> updatePage (Pageable pageable, List<T> results) { 
int pageSize = pageable.getPageSize(); 
int pageOffset = pageable.getOffset (); 
int total = pageOffset + results.size() + (results.size() == pageSize?pageSize:0); 
return new PageImpl (results, pageable, (long)total); 
} 
private SortOrder convert (Sort sort) { 
SortOrder sortOrder = new SortOrder(); 


ifl(sort != null) { 
Iterator var3 = sort.iterator(); 
while (var3.hasNext ()) { 
Sort.Order order = (Sort.Order)var3.next (); 
if(order.isAscending()) { 
sortOrder.add (new String[]{order.getProperty()}); 
} else { 


sortOrder.add (SortOrder.Direction.DESC, new String[] {order. 
getProperty () }) 7 
} 
} 
} 


return sortOrder; 














这 样 在 进行 分 页 查询 时 ， 就 可 以 调用 这 个 服务 类 ， 代 码 清单 11-13 是 使 用 电影 名 称 ， 分 页 查询 电影 列表 的 一 个 实现 例子 。 














代码 清单 11-13 ”使 用 分 页 查询 服务 类 进行 分 页 查询 的 例子 





@Autowired 
Private PagesService<Movie> pagesService; 
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@RequestMapping (value="/1ist") 
public Page<Movie> list (HttpServletRequest request) throws Exception{ 
String name = request .getParameter ("name"); 
String page = request .getParameter ("page"); 
String size = request .getParameter ("size"); 
Pageable pageable = new PageRequest (Page==nul1? 0: Integer.ParseInt (page), 
size==null? 10:Integer.parseInt (size), 
new Sort(Sort.Direction.DESC, "id")); 
Filters filters = new Filters(); 
if (!StringUtils.isEmpty(name)) { 
Filter filter = new Filter("name", name); 
filters.add (filter); 
EF 
return pagesService.findAll (Movie.class, pageable, filters); 





位 有 直 骆 











在 Spring Boot 中 访问 数据 库 为 什么 如 此 简单 ”从 对 一 些 核心 源 代 码 的 分 析 中 可 知 ， 它 始终 遵循 一 套 在 业界 中 广 为 流 行 的 JPA 标 准 规范 来 设计 ， 无 论 是 哪 种 数据 库 ， 它 都 能 使 用 相同 且 简 单 的 方法 来 访 
避 。 只 是 ， 这 对 于 一 些 复杂 的 功能 需求 来 说 ， 未 免 有 些 欠缺 。 所 以 ， 在 认识 它 的 实现 原理 之 后 ， 需 要 借助 一 些 底层 调用 来 加 强 和 扩展 访问 数据 库 的 功能 。 
































全 

















通过 分 析 一 些 核心 源 代码 ， 我 们 认识 到 Spring Boot 提 供 的 一 些 可 以 简单 使 用 的 组 件 中 蕴藏 的 强大 功能 ， 也 是 通过 内 部 的 复杂 实现 来 完成 的 。 下 一 章 将 剖析 微服 务 的 内 部 实现 原理 ， 看 看 那些 可 以 拿 来 即 
的 微服 务 ， 其 内 部 的 实现 原理 又 是 怎样 的 。 





























第 12 章 ”微服 务 核心 技术 实现 原理 




















Spring Cloud 是 基于 对 Netflix 开 源 组 件 进一步 封装 的 一 套 云 应 用 开发 工具 ， 可 以 用 来 开发 各 种 微服 务 应 用 ， 它 包含 很 多 组 件 (或 子 项 目 ) 








表 12-1 Spring Cloud 组 件 列表 


组 件 功能 
spring-cloud-netflix 集成 多 种 Netflix 组 件 提供 的 开发 工具 包 ， 包 括 Eureka、 
spring-cloud-eureka 发 现 服务 工具 包 ， 用 于 实现 云端 的 负载 均衡 和 中 间 扩 


spring-cloud-hystrix 


spring-cloud-zuul 边缘 服务 工具 包 ， 提 供 动态 路 由 、 监 控 、 弹 性 、 


事件 总 线 工 具 ， 用 于 在 集群 中 使 用 分 布 式 消息 传播 状态 变 
cloud-config 结合 使 用 ， 实 现 配置 的 在 线 更 新 功能 


spring-cloud-bus 


， 表 12-1 列 出 了 一 些 3 








要 组 件 及 其 功能 说 明 。 


ee Zuul 、Archaius 等 
务 器 的 故障 转移 等 功能 
容错 和 监控 管理 工具 ， 通 过 控制 服务 和 第 三 方 库 的 节点 ， 对 延迟 和 故障 提供 更 


妇 全 等 的 边缘 服务 


spring-cloud-cli 基于 Spring Boot CLI 的 命令 行 工具 ， 可 以 快速 建立 云 组 件 


配置 管理 开发 工具 包 ， 可 以 把 配置 放 到 远程 服务 


spring-cloud-config 
Git 以 及 Subversion 


spring-cloud-security 安全 管理 工具 包 ， 为 应 用 程序 添加 安全 控制 管理 等 功能 


FF 化， 可 与 Spring- 


器 上 ， 目 前 支持 本 地 存储 、 


通过 Oauth2 协议 绑 定 服务 到 CloudFoundry，CloudFoundry 是 VMware 推出 的 


spring-cloud-cloudfoundry 开源 Paas 云 平 
aa - 台 


封装 了 Consul 操作 ，Consul 是 一 个 服务 发 现 
无 颖 集成 


spring-cloud-consul 


组 件 功能 
消息 收发 工具 包 ， 可 以 在 云 应 用 中 使 用 简单 的 档 


spring-cloud-stream pe 
等 收发 消息 


与 配置 工具 ， 


与 Docker 容 虎 可 以 


英 式 与 Redis 、RabbitMQ 、Kafka 


spring-cloud-zookeeper 叶 作 Zookeeper 的 工具 包 ， 用 于 使 用 Zookeeper 方式 的 服 




















注册 和 发 现 


在 第 8 章 的 实例 工程 中 已 经 使 用 了 其 中 的 配置 管理 、 发 现 服务 、 监 控 服务 、 动 态 路 由 、 断 路 器 、 负 载 均衡 等 功能 。 本 章 将 从 实现 的 角度 探索 配置 管理 、 发 现 服务 和 负载 均衡 服务 等 的 实现 原理 。 

















12.1 配置 管理 实现 原理 



































在 第 8 章 的 实例 中 ， 我 们 知道 ， 配 置 管理 的 在 线 更 新 功能 使 用 事件 总 线 ， 即 spring-cloud-bus 来 发 布 状态 变化 ， 并 且 使 用 分 布 式 消 息 来 发 布 更 新 事件 ， 而 分 布 式 消息 最 终 使 用 了 RabbitM Q 来 实现 消息 收 











发 。 


12.1.1 在线 更 新 流程 

















使 用 配置 管理 ， 实 现在 线 更 新 一 般 遵循 下 列 步骤 : 





1) 更 新 Git 仓 库 的 配置 文件 。 
2) 以 POST 指令 触发 更 新 请 求 。 
3) 配置 管理 服务 器 从 Git 仓 库 中 读 取 配 置 文件 ， 并 将 配置 文件 分 发 给 各 个 客户 端 ， 同 时 在 RabbitMQ 中 发 布 一 个 更 新 消息 。 


4) 客户 端 订阅 RabbitMQ 消 息 ， 收 到 消息 后 执行 更 新 。 




















在 使 用 配置 管理 的 演示 实例 中 ， 使 用 如 下 POST 指令 来 触发 在 线 更 新 : 


























curl -X POST http://localhost:8888/bus/refresh 

















接收 这 个 更 新 指令 的 实现 方法 如 代码 清单 12-1 所 示 ， 其 中 的 publish 将 会 发 布 一 个 更 新 事件 ， 调 用 RabbitM Q 进 行 消息 发 布 ， 然 后 由 客户 端 收 到 消息 后 执行 更 新 。 代 码 中 定义 了 请 求 更 新 的 链接 








refresh， 并 可 使 用 destination 来 指定 更 新 目标 。 


代码 清单 12-1 ”接收 更 新 指令 的 源 代码 





package org.springframework.cloud.bus.endpoint; 
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public class RefreshBusEndpoint extends AbstractBusEndpoint { 
public RefreshBusEndpoint (ApplicationEventPublisher context, String id, Bus 
Endpoint delegate) { 
super (context, id, delegate); 
@RequestMapping( 
value {"refresh"}, 
method = {RequestMethod.POST} 





) 


@ResponseBody 
public void refresh (@RequestParam( 
Value = "destination", 


required = false 
) String destination) { 
this.publish (new RefreshRemoteApplicationEvent (this, this.getIinstance 
Id(), destination)); 
} 
} 





12.1.2 ”更 新 消息 的 分 发 原理 











配置 管理 服务 器 中 的 消息 分 发 是 从 spring-cloud-bus 中 调用 spring-cloud-stream 组 件 来 实现 的 ， 而 spring-cloud-stream 使 用 RabbitMQ 实 现 了 分 布 式 消息 的 分 发 。 


























RabbitMQ 的 消息 服务 一 般 需 要 创建 一 个 交换 机 Exchange 和 一 个 队列 Queue， 然 后 将 交换 机 和 队列 进行 绑 定 。 而 在 设计 配置 服务 器 时 并 没有 做 这 方面 的 工作 ， 所 做 的 工作 仅仅 是 配置 引用 spring- 
cloud-bus 的 依赖 和 设置 连接 RabbitM Q 服 务 器 的 参数 而 已 。 这 个 工作 其 实 已 经 由 spring-cloud-stream 帮 有 我 们 实现 了 。 


























从 RabbitMessageChannelBinder 的 源 代码 中 可 以 看 到 这 部 分 的 实现 原理 ， 代 码 清单 12-2 是 一 个 消息 发 布 方 的 队列 绑 定 的 实现 。 其 中 exchangeName 是 一 个 交换 机 的 名 字 ，baseQueueName 是 一 个 
队列 的 名 字 ， 并 且 从 代码 中 也 可 以 看 出 它 使 用 了 TopicExchange 交 换 机 ， 这 是 RabbitM Q 中 4 种 交换 机 (Fanout、Direct、Topic、Header) 的 其 中 一 种 ， 并 且 也 可 以 看 出 代码 中 使 用 setRoutingKey 将 交换 
机 和 队列 做 了 绑 定 。 























代码 清单 12-2 RabbitMessageChannelBinder 的 源 代 码 





Package org.springframework.cloud.stream.binder.rabbit; 
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public class RabbitMessageChannelBinder extends MessageChannelBinderSupport implements DisposableBean { 
private AmqpOutboundEndpoint buildoutboundEndpoint (String name, RabbitMessage 
ChannelBinder .RabbitPropertiesAccessor properties, RabbitTemplate rabbitTemplate) { 
String prefix = properties.getPrefix(this.defaultPrefix); 
String exchangeName = applyPrefix (prefix, name); 
String partitionKeyExtractorClass = properties.getPartitionKeyExtractor 
Class(); 
Expression partitionKeyExpression = properties.getPartitionKeyExpression(); 
TopicExchange exchange = new TopicExchange (exchangeName); 
this.declareExchange (exchangeName, exchange); 
AmqpOutboundEndpoint endpoint = new AmqpOutboundEndpoint (rabbitTemplate); 
endpoint .setExchangeName (exchange .getName () ) 7 
String baseQueueName = exchangeName + ".default"; 
if (partitionKeyExpression == null && !StringUtils.hasText (partitionKey 
ExtractorClass)) { 
Queue varl5 = new Queue (baseQueueName, true, false, false, this. 
queueArgs (properties, baseQueueName)); 
this.declareQueue (baseQueueName, varl5); 
this.autoBindDLQ (baseQueueName, baseQueueName, properties); 
endpoint.setRoutingKey (name); 
org.springframework.amqp.core.Binding var16 = BindingBuilder.bind 
(var15) .to (exchange) .with (name); 
this.declareBinding (baseQueueName，var16) 
} else { 
endpoint .setExpressionRoutingKey (EXPRESSION PARSER.parseExpression 
(this.buildPartitionRoutingExpression (name))); 上 
for(int i = 0; i < Properties.getNextModuleCount (); ++i) { 
String partitionSuffix = "-" + i; 
String partitionQueueName = baseQueueName + partitionSuffix; 
Queue queue = new Queue (partitionQueueName, true, false, false, 
this.queueArgs (properties, partitionQueueName)); 
this.declareQueue (queue .getName (), queue); 
this.autoBindDLQ (baseQueueName, baseQueueName + PartitionSuffixy 






properties); 
this.declareBinding (queue.getName (), BindingBuilder.bind (queue). 
to (exchange) .with (name + partitionSuffix)); 
} 
} 
this.configureOutboundHandler (endpoint, properties); 
return endpoint; 
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现在 我 们 更 加 明白 ， 为 什么 使 用 Spring Boot 可 以 那么 简单 ， 就 是 因为 一 些 复杂 的 配置 和 方法 都 已 经 由 Spring Boot 及 其 所 调用 的 一 些 组 件 实现 了 。 至 于 在 使 用 RabbitMQ 中 进行 消息 发 布 的 实现 ， 最 终 
是 由 RabbitTemplate 执 行 doSend， 将 消息 发 布 到 RabbitM Q 服 务 器 上 ， 如 代码 清单 12-3 所 示 。 












































代码 清单 12-3 ”消息 发 布 源 代 码 


package org.springframework.amqp.rabbit .core; 
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public class RabbitTemplate extends RabbitAccessor implements BeanFactoryAware, 到 
RabbitOperations, MessageListener, ListenerContainerAware, Listener { 
public void send (Message message) throws AmqpException { 
this.send (this.exchange, this.routingKey, message); 
} 
public void send (final String exchange, final String routingKey, final Message 
message, final CorrelationData correlationData) throws AmqpException { 
this.execute (new ChannelCallback() { 
public Object doInRabbit (Channel channel) throws Exception { 
RabbitTemplate.this.doSend (channel, exchange, routingkey, 
message, RabbitTemplate.this.returnCallback != null && ((Boolean)RabbitTemplate. 
this.mandatoryExpression.getValue (RabbitTemplate.this.evaluationContext, 
message, Boolean.class)) .booleanValue () ， correlationData); 
return null; 
} 
}, this.obtainTargetConnectionFactoryIfNecessary (this.sendConnection 
FactorySelectorExpression, message)); 
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使 用 配置 管理 服务 的 客户 端 都 订阅 了 RabbitMQ 服 务 器 的 消息 ， 当 收 到 更 新 消息 时 ， 即 从 配置 管理 服务 器 中 取得 更 新 文件 ， 然 后 在 本 地 上 执行 更 新 配置 的 流程 。 














有 关 消 息 的 发 布 和 订阅 的 实现 方法 ， 最 后 通过 一 个 简单 的 实例 ， 使 用 spring-cloud-stream， 更 加 形象 地 说 明 这 种 分 布 式 消息 的 发 布 和 接收 的 原理 。 





12.2 ”发 现 服 务 源 代码 剖析 




















使 用 发 现 服务 时 ， 只 要 简单 地 通过 注解 @EnableEurekaServer 来 标注 一 个 应 用 为 发 现 服务 器 ， 通 过 注解 @EnableDiscoveryClient 来 标注 一 个 应 用 为 发 现 服务 的 客户 端 ， 服 务 器 就 会 实现 服务 注册 的 功 
能 ， 客 户 端 将 会 从 服务 器 中 取得 已 经 注册 的 可 用 服务 列表 。 



































12.2.1 ”服务 端的 服务 注册 功能 














服务 注册 是 发 现 服务 的 一 个 主要 功能 ， 可 以 从 注解 @EnableEurekaserver 的 定义 中 顺 荐 摸 瓜 地 找到 


EurekaserverConfiguration 。 


实现 的 源 代 码 ， 如 代码 清单 12-4 所 示 ， 其 中 @Import 将 导入 一 个 发 现 服务 的 配置 : 











代码 清单 12-4 注解 @EnableEurekaServer 源 代码 





Package org.springframework.cloud.netflix.eureka.server; 
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QTarget ({ElementType.TYPE}) 
@Retention (RetentionPolicy.RUNTIME) 

Q@Documented 

@Import ({EurekaServerConfiguration.class}) 

public Qinterface EnableEurekaServer { 

} 














通过 EurekaServerConfiguration， 又 引入 了 一 些 配 置 ， 如 增加 了 监控 器 和 过 





虑 器 的 配置 等 ， 其 中 一 个 InstanceRegistry 的 配置 将 实现 对 客户 端的 注册 ， 如 代码 清单 12-5 所 示 。 





代码 清单 12-5 ”EurekaServerConfiguration 源 代码 


package org.springframework.cloud.netflix.eureka.server; 
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@Configuration 
@Import ({EurekaServerInitializerConfiguration.class}) 
QEnableDiscoveryClient 
@EnableConfigurationProperties ({EurekaDashboardProperties.class}) 
public class EurekaServerConfiguration extends WebMvcConfigurerAdapter { 
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@Bean 
public PeerAwareInstanceRegistry peerAwareInstanceRegistry (ServerCodecs 
serverCodecs) { 
this.eurekaClient .getApplications () 7 
return new InstanceRegistry (this.eurekaServerConfig, this.eurekaClient 
Config, serverCodecs, this.eurekaClient, this.expectedNumberOfRenewsPerMin, this.defaultOpenForTrafficCount); 
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上 面 的 InstanceRegistry 调 用 了 超 类 AbstractlnstanceRegistry 的 register 对 客户 端 进行 注册 ， 然 后 将 在 线 的 客户 端 存 入 注册 队列 recentRegisteredQueue 中 ， 如 代码 清单 12-6 所 示 。 


代码 清单 12-6 ” 超 类 AbstractinstanceRegistry 源 代码 片段 


package com.netflix.eureka.registry; 
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public abstract class AbstractInstanceRegistry implements InstanceRegistry { i 
private static final Logger logger = LoggerFactory.getLogger (AbstractInstance 
Registry.class); 
Private static final String[] EMPTY STR ARRAY = new String[0]; 
private final ConcurrentHashMap<String, Map<String, Lease<InstanceInfo>>> 
registry = new ConcurrentHashMap () 7 
protected Map<String, RemoteRegionRegistry> regionNameVSRemoteRegistry = new 
HashMap (); 
protected final ConcurrentMap<String, InstanceStatus> overriddenInstance 
StatusMap; 
Private final AbstractIinstanceRegistry.CircularQueue<Pair<Long, String>> 
recentRegisteredQueue; 
private final AbstractIinstanceRegistry.CircularQueue<Pair<Long, String>> 
recentCanceledQueue; 
Private ConcurrentLinkedQueue<AbstractIinstanceRegistry.RecentlyChangedItem> 
recentlyChangedQueue; 
http://www.hzcourse.com/resource/readBook?path=/openresources/teach ebook/uncompressed/15925/0EBPS/Text/..http://www.hzcourse.com/resource/readBook?path=/openresources/teac 
Public void register (InstanceInfo r, int leaseDuration, boolean isReplication) { 
try { 
this.read.lock(); 
Object gMap = (Map)this.registry.get(r.getAppName ()); 
EurekaMonitors .REGISTER. increment (isReplication); 
if(gMap 一 null) { 
ConcurrentHashMap existingLease = new ConcurrentHashMap () 7 
gMap = (Map)this.registry.putIfAbsent (r.getAppName (), existing 
Lease); 
if(gMap == null) { 
gMap = existingLease; 


} 
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( (Map) gMap) .put (r.getId(), lease2); 
AbstractInstanceRegistry.CircularQueue overriddenStatusFromMapl = this. 
recentRegisteredQueue; 
synchronized (this.recentRegisteredQueue) { 
this.recentRegisteredQueue.add (new Pair (Long.valueOf (System. 
currentTimeMillis()), r.getAppName() + "(" + r.getId() + ")")); 
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下 











客户 端 在 发 现 服务 器 中 注册 之 后 ， 就 可 以 在 发 现 服务 器 的 控制 台 上 ， 查 看 在 线 的 客户 端 列表 。 这 里 有 一 个 缺陷 ， 如 果 客 户 端 关闭 了 ， 在 发 现 服务 器 的 控制 台中 ， 还 能 查 到 这 个 客户 端 , 
务 器 ， 才 能 更 新 这 个 客户 端 列表 。 


发 现 服 


12.2.2 ”客户 端 注册 和 提取 服务 列表 














客户 端 除了 自身 在 发 现 服务 器 上 注册 之 外 ， 它 还 要 从 服务 器 中 取得 已 经 注册 的 其 他 客户 端 ， 以 得 到 一 个 可 用 的 服务 列表 (其 他 注册 的 客户 端 。 这 部 分 的 核心 源 代码 可 以 在 
com.netflix.discovery.DiscoveryClient 中 找到 。 


























客户 端 自身 注册 的 实现 方法 如 代码 清单 12-7 所 示 。 这 里 ， 主 要 是 将 客户 端的 名 称 、IP 地 址 和 端口 等 信息 通过 一 个 instancelnfo 对 象 发 给 发 现 服务 器 进行 注册 。 




















代码 清单 12-7 ”客户 端 注册 源 代码 





Package com.netflix.discovery; 
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public class DiscoveryClient implements EurekaClient { 
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boolean register() throws Throwable { 
logger.info ("DiscoveryClient " + this.appPathIdentifier + ": registering 
servicehttp://www.hzcourse.com/resource/readBook?path=/openresources/teach ebook/uncompressed/15925/OEBPS/Text/..."); 
if (this.shouldUseExperimentalTransportForRegistration()) { 
EurekaHttpResponse responsel; 
try { 
responsel = this.eurekaTransport.registrationClient.register 
(this.instanceInfo); 
} catch (Exception var7) { 
logger.warn("{} - registration failed {}", new Object[]{"Discovery 
Client " + this.appPathIdentifier, var7.getMessage(), var7}); 
throw var7; 
E 
this.isRegisteredWithDiscovery = true; 
if(logger.isInfoPnabled()) { 
logger.info("{} - registration status: {}", "DiscoveryClient " 
+ this.appPathIdentifier, Integer.valueOf (responsel .getStatusCode())); ° 
} 
return responsel .getStatusCode() == 204; 
} else { 
ClientResponse response = null; 
boolean e; 
try { 
response = this.makeRemoteCall (DiscoveryClient .Action.Register); 
this.isRegisteredWithDiscovery = true; 


logger.info("{} - registration status: {}", "DiscoveryClient " 
+ this.appPathIidentifier, response != null?Integer.valueOf (response.getStatus()):"not sent"); 
e = response != null && response.getStatus () 一 204; 


} catch (Throwable var8) { 
logger.warn("{} - registration failed {}", new Object[]{"Disco 
very | Client " + this.appPathIdentifier, var8.getMessage(), var8}); 
throw var8; 
} finally { 
this.closeResponse (response); 
} 
return e; 


bE: 
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客户 端 执 行 注册 使 用 计划 任务 的 方式 来 实现 ， 而 客户 端 从 发 现 服务 器 中 更 新 其 他 在 线 的 客户 端 列表 ， 也 使 用 了 一 个 定时 任务 来 管理 。 代 码 清单 12-8 使 用 一 个 定时 任务 TimerTask 定 时 从 发 现 服务 器 中 取 
得 其 他 在 线 的 客户 端 列 表 ， 以 备 使 用 。 















































代码 清单 12-8 ”更 新 客户 端 列 表 定 时 器 源 代码 


package com.netflix.discovery; 
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public class DiscoveryClient implements EurekaClient { 加 加 
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private TimerTask getServiceUrlUpdateTask (final String zone) { a 
return new TimerTask() { 
public void run() { 
try { 
List e = DiscoveryClient.this.timedGetDiscoveryServiceUrls 
(zone); 
if(e.isEmpty()) { 
DiscoveryClient.logger.warn ("The service Url list is 
empty"); 
return; 


} 


if(!e.equals (DiscoveryClient .this.eurekaServiceUrls.get 


| 
DiscoveryClient .logger.info ("Updating the serviceUrls 
as they seem to have changed from {} to {} ", Arrays.toString(((List)DiscoveryClient.this.eurekaServiceUrls.get()).toArray()), Arrays.toSstring(e.toArray())); 
DiscoveryClient.this.eurekaServiceUrls.set (e); 
} 
} catch (Throwable var2) { 
DiscoveryClient .logger.error ("Cannot get the eureka service 


人 


Ea 
} 
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由 





纯 的 发 现 服务 ， 并 不 能 看 出 它 有 多 大 的 用 途 ， 它 只 有 与 动态 路 由 、 负 载 均衡 和 监控 服务 等 一 起 使 用 ， 才 能 发 挥 其 强大 的 功能 。 














12.3 ”负载 均衡 源 代码 剖析 


























当 一 个 应 用 启用 发 现 服务 的 功能 之 后 ， 会 默认 启用 Ribbon 的 负载 均衡 服务 。Ribbon 通 过 发 现 服务 获取 在 线 的 客户 端 ， 为 具有 多 个 实例 的 客户 端 建立 起 负载 均衡 实例 列表 ， 然 后 通过 一 定 的 负载 均衡 算 
法 ， 实 现 负载 均衡 的 管理 机 制 。 















































如 代码 清单 12-9 所 示 ，Ribbon 默 认 结合 使 用 Eureka 发 现 服务 ， 启 用 负载 均衡 管理 机 制 。 当 没有 配置 “ribbon.eureka.enabled” 参 数 时 ， 它 默认 被 设 定 为 true。 








代码 清单 12-9 ” 读 取 启 用 负载 均衡 配置 的 源 代码 


package org.springframework.cloud.netflix.ribbon.eureka; 
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@Configuration > 加 
@EnableConfigurationProperties 
@ConditionalOnClass ({DiscoveryEnabledNIWSServerList.class}) 
@ConditionalOnBean ({SpringClientFactory.class}) 
@ConditionalOnProperty( 
value = {"ribbon.eureka.enabled"}, 
matchIfMissing = true 
) 
QAutoConfigureAfter ({RibbonAutoConfiguration.class}) 
@RibbonClients( 
defaultConfiguration = {EurekaRibbonClientConfiguration.class} 
) 
public class RibbonEurekaAutoConfiguration { 
public RibbonEurekaAutoConfiguration() { 
} 












































看 看 负载 均衡 服务 是 如 何 进行 初始 化 的 ， 就 更 清楚 它 的 实现 原理 了 。 代 码 清单 12-10 是 BaseLoadBalancer 的 部 分 源 代 码 。 这 里 ， 程 序 加 载 了 一 些 初始 配置 ， 如 可 用 的 负载 均衡 服务 实例 列表 、 监 控 计 数 
和 服务 状态 监听 等 ， 其 中 一 个 重要 的 设置 ， 即 设 定 默认 的 负载 均衡 规则 RoundRobinRule， 这 是 一 个 使 用 简单 轮 询 算法 的 负载 均衡 规则 。 一 个 负载 均衡 服务 的 实现 ， 就 是 通过 一 定 的 负载 均衡 算法 ， 从 可 
的 服务 实例 列表 中 ， 为 请 求 者 提供 一 个 可 用 的 服务 。 













































































代码 清单 12-10 ”BaseLoadBalancer 源 代码 片段 


package com.netflix.loadbalancer; 
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public class BaseLoadBalancer extends AbstractLoadBalancer implements Prime = 
ConnectionListener, IClientConfigAware { 
private static Logger logger = LoggerFactory.getLogger (BaseLoadBalancer. 
class); 
private static final IRule DEFAULT RULE = new RoundRobinRule(); 
Private static final String DEFAULT NAME = "default" 
private static final String PREFIX = "LoadBalancer 
protected IRule rule; 
protected IPing ping; 








@Monitor( 
name = "LoadBalancer AllServerList", 
type = DataSourceType.INFORMATIONAL 
) 
protected volatile List<Server> allServerList; 
@Monitor( 
name = "LoadBalancer UpServerList", 
type = DataSourceType.INFORMATIONAL 


) 

public BaseLoadBalancer() { 
this.rule = DEFAULT RULE” 
this.ping = null; 
this.allServerList = Collections.synchronizedList (new ArrayList ()); 
this.upServerList = Collections.synchronizedList (new ArrayList ()); 
this.allServerLock new ReentrantReadWriteLock () 7 
this.upServerLock = new ReentrantReadWriteLock(); 
this.name = "default"; 
this.lbTimer = null; 
this.pingIntervalSeconds = 10; 
this.maxTotalPingTimeSeconds = 5; 
this.serverComparator = new ServerComparator(); 
this.pingInProgress = new AtomicBoolean (false); 
this.counter = Monitors.newCounter ("LoadBalancer ChooseServer"); 
this.enablePrimingConnections = false; 3 
this.changeListeners = new CopyOnWriteArrayList (); 
this .serverStatusListeners = new CopyOnWriteArrayList (); 
this.name = "default"; 
this.ping = null; 
this.setRule (DEFAULT RULE); 
this.setupPingTask ()7 
this.lbStats = new LoadBalancerStats ("default"); 
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再 来 看 看 RoundRobinRule 的 实现 代码 ， 如 代码 清单 12-11 所 示 。 从 中 可 以 看 出 ， 它 使 用 一 个 循环 ， 从 可 用 的 服务 列表 中 ， 按 顺序 选择 一 个 可 用 的 服务 。 其 中 ， 一 个 选择 服务 的 请 求 不 能 超过 10 次 无 效 
尝试 ， 这 仅仅 是 一 个 循环 语句 的 安全 设计 而 已 ， 并 不 会 影响 一 次 选择 查询 。 









































从 整体 上 来 说 ， 使 用 哪 种 负载 均衡 算法 ， 对 于 整个 负载 均衡 服务 来 说 ， 影 响 并 不 是 很 大 。 除 了 RoundRobinRule，Ribbon 还 提供 了 其 他 一 些 负载 均衡 规则 ， 如 加 权 响 应 时 间 规 则 
WeightedResponseTimeRule、 区 域 感知 规则 ZoneAvoidanceRule、 随 机 规则 RandomRule 等 。 





代码 清单 12-11 RoundRobinRule 源 代码 片段 





package com.netflix.loadbalancer; 
http://www.hzcourse.com/resource/readBook?path=/openresources/teach ebook/uncompressed/15925/0EBPS/Text/. .http://www.hzcourse.com/resource/readBook?path=/openresources/teach ek 
public class RoundRobinRule extends AbstractLoadBalancerRule { 
AtomicInteger nextIndexAI; 
Private static Logger 1og = LoggerFactory.getLogger (RoundRobinRule.class); 
static final boolean availableonly = false; 
public RoundRobinRule() { 
this .nextIndexAI = new ALomicInteger (0); 
} 
http://www.hzcourse.com/resource/readBook?path=/openresources/teach ebook/uncompressed/15925/0EBPS/Text/. .http://www.hzcourse.com/resource/readBook?path=/openresources/teach ek 
public Server choose (ILoadBalancer lb, Object key) { 
if(lb == null) { 
log.warn("no load balancer"); 
return null; 
} else { 
Server server 
boolean index 
int count = 0; 
while(true) { 
if(server == null && count++ < 10) { 
List upList = lb.getServerList (true); 
List allList = lb.getServerList (false); 
int upCount = upList.size(); 
int serverCount = allList.size(); 
if(upCount != 0 && serverCount != 0) { 
int varl0 = this.nextIndexAI.incrementAndGet () % server 


null; 
false; 


Count; 
server = (Server)allList.get (var10); 
if(server == null) { 
Thread.yield(); 
} else { 
if(server.isAlive() && server.isReadyToServe()) { 


return server; 
} 
server = null; 
} 
continue; 
} 
log.warn ("No up servers available from load balancer: " + 1b); 
return null; 
} 
if(count >= 10) { 
log.warn ("No available alive servers after 10 tries from 
load balancer: " + 1b); 
} 


return server; 
} 


http://www.hzcourse.com/resource/readBook?path=/openresources/teach ebook/uncompressed/15925/OEBPSVText/. .http://www.hzcourse.com/resource/readBook?path=/openresources/teack 


} 






































例如 在 第 9 章 的 演示 中 ， 当 把 其 中 的 data 服 务 配 置 为 两 个 或 两 个 以 上 的 运行 实例 时 ， 就 会 启动 Ribbon 的 负载 均衡 机 制 ， 用 来 管理 其 他 服务 对 data 服 务 的 访问 。 我 们 只 是 使 用 了 默认 的 简单 轮 询 负载 均衡 
规则 ， 即 第 一 次 调用 将 访问 第 一 个 服务 实例 ， 第 二 次 调用 将 访问 第 二 个 服务 实例 ， 以 此 类 推 ， 当 调用 到 服务 列表 的 最 后 一 个 服务 后 再 从 头 来 过 。 





















































12.4 分布 式 消息 实现 原理 演示 



































使 用 RabbitMQ 实 现 分 布 式 消息 分 发 ， 在 分 布 式 系统 中 具有 很 大 的 用 途 ， 为 各 个 应 用 之 间 传递 消息 和 数据 提供 了 很 大 的 方便 ， 并 且 














松散 耦合 的 结构 和 异步 处 理 的 机 制 不 会 影响 系统 的 性 能 。 





























使 用 spring-cloud-stream 可 以 非常 简单 地 使 用 RabbitMQ 的 异步 消息 ，Spring Cloud 的 配置 管理 中 的 分 布 式 消息 分 发 也 是 通过 调用 spring-cloud-stream 组 件 来 实现 的 。 下 面 将 创建 一 个 消息 生产 者 和 











一 个 消息 消费 者 来 演示 消息 分 发 的 实现 原理 。 


12.4.1 消息 生产 者 

















消息 生产 者 的 实现 如 代码 清单 12-12 所 示 ， 这 里 主要 创建 了 一 个 POST 接口 “/send”， 以 接收 传 入 的 Map 对 象 作为 参数 ， 使 用 MessageChannel 的 send 方 法 ， 将 消息 发 布 到 RabbitM Q 的 消息 队列 上 。 


使 用 Map 对 象 的 目的 ， 是 保证 消息 生产 者 和 消息 消费 者 之 间 ， 可 以 使 用 相同 的 对 象 来 存 取消 息 的 内 容 ， 这 就 要 求 双方 必须 事先 约定 Map 对 象 的 字段 。 
























































代码 清单 12-12 消息 生产 者 主 程序 





@EnableBinding (Source.class) 
@RestController 
@SpringBootApplication 
public class SenderApplication { 
@Autowired 
@Output (Source .OUTPUT) 
private MessageChannel channel; 
QRequestMapping (method = RequestMethod.POST, path = "/send") 
public void write (@RequestBody Map<String, Object> msg){ 
channel .send (MessageBuilder.withPayload (msg) .build()); 
} 
public static void main (String[] args) { 
SpringApplication.run (SenderApplication.class, args); 
} 





























代码 清单 12-13 是 消息 生产 者 这 个 工程 的 配置 文件 ， 其 中 stream 配 置 的 目的 地 为 cloud-stream， 客 户 端 订阅 时 必须 使 用 相同 的 目的 地 ， 注 意 这 里 绑 定 的 方式 是 output，rabbitmq 是 连接 消息 服务 器 的 
一 些 参 数 配置 。 















































代码 清单 12-13 ”消息 生产 者 工程 配置 文件 





server: 
port: 80 
spring: 
Qlood: 
Stream: 
bindings: 
output: 
destination: cloud-stream 
rabbitmq: 
addresses: amqp:// 192.168.1.216:5672 
username: alan 
password: alan 





12.4.2 ”消息 消费 者 





消息 消费 者 的 实现 如 代码 清单 12-14 所 示 ， 这 里 从 SubscribableChannel ( 即 Sink.INPUT) 订阅 了 通道 的 消息 ， 它 相当 于 一 个 监听 器 ， 当 订阅 的 通道 上 有 消息 发 布 时 ， 就 将 消息 取 回 来 ， 然 后 简单 地 在 
控制 台 上 打印 出 来 。 这 里 使 用 的 Map 对 象 ， 跟 消息 生产 者 约定 了 两 个 使 用 字段 ， 即 msg 和 name。 






































代码 清单 12-14 ”消息 消费 者 主 程序 





@EnableBinding (Sink.class) 
QIntegrationComponentScan 
Q@MessagePndpoint 
@SpringBootApplication 
public class ReceiverApplication { 

@ServiceActivator (inputChannel=Sink.INPUT) 

public void accept (Map<String, Object> msg){ 

System.out .Println (msg.get ("msg") .toString() + ":" + msg.get ("name")); 


public static void main (String[] args) { 
SpringApplication.run (ReceiverApplication.class, args); 


} 




















代码 清单 12-15 是 消息 消费 者 工程 的 配置 文件 ， 它 与 消息 生产 者 有 相同 的 目的 地 ， 不 同 的 是 它 的 绑 定 方式 是 input， 其 中 rabbitmq 的 配置 是 相同 的 ， 只 要 连 上 RabbitMQ 消 息 服务 器 即 可 。 





代码 清单 12-15 “消息 消费 者 工程 配置 文件 





server: 
port: 81 
spring: 
cloud: 
Stream: 
bindings: 
input: 
destination: cloud-stream 
group: groupl 
consumer: 
durableSubscription: true 
rabbitmq: 
addresses: amqp:// 192.168.1.216:5672 
username: alan 
password: alan 





这 样 ， 当 两 个 工程 都 启动 之 后 ， 输 入 下 列 POST 指 令 ， 就 可 以 将 消息 从 消息 生产 者 中 发 布 出 去 。 





curl -1 -HB "Content-type:application/json" -X POST -d'{"msg":"Hello", "name":"RabbitMQ"}' http://localhost/send 





其 中 消息 结构 中 的 msg 和 name 就 是 约定 好 的 字段 。 这 时 ， 在 消息 消费 者 的 控制 台 上 可 以 看 到 接收 到 了 如 下 信息 : 





Hello:RabbitMO 








从 上 面 的 演示 可 以 看 出 ， 使 用 spring-cloud-stream 来 实现 分 布 式 消息 的 分 发 和 接收 都 是 非常 简单 的 。 上 面 实例 工程 的 完整 代码 可 以 从 GitHub 中 检 出 : https://github.com/chenfromsz/spring- 


























cloud-stream-demo.git. 


人 25 水 结 














本 章 分 析 了 Spring Cloud 一 系列 微服 务 中 配置 服务 、 发 现 服务 和 负载 均衡 服务 的 实现 原理 和 部 分 核心 源 代 码 ， 并 使 用 一 个 简单 的 实例 ， 演 示 了 使 用 分 布 式 消息 的 简单 实现 方法 ， 从 中 让 我 们 更 加 清楚 : 
认识 到 ，Spring Boot 及 其 一 些 相关 的 组 件 ， 已 经 尽量 把 一 些 可 以 实现 和 做 到 的 功能 ， 都 帮 有 我 们 实现 了 。 所 以 ， 昌 然 使 用 Spring Boot 及 其 相关 组 件 看 起 来 非常 简单 ， 但 实际 上 可 以 实现 无 比 强大 的 功能 ， 这 
就 是 Spring Boot 及 其 组 件 的 神奇 所 在 。 



























































有 关 Spring Cloud 的 更 多 内 容 和 参考 ， 可 以 访问 其 官方 网 站 : http://projects.spring.io/spring-cloud/ 和 http://projects.spring.io/spring-cloud/spring-cloud.html。 


附录 A ”安装 Neo4j 




















Neo4j 数 据 库 有 两 个 版 本 : 社区 版 和 商业 版 ， 社 区 版 是 开源 并 且 免 费 的 。 社 区 版 与 商业 版 功能 上 没有 什么 区 别 ， 不 同 的 是 社区 版 只 能 单机 使 用 ， 商 业 版 可 以 做 分 布 式 集群 。 单 机 版 最 大 可 以 存储 10 亿 个 


























Neo4j 针 对 不 现 的 操作 系统 ， 如 MAC OSX、Linux、Windows 等 提供 不 同 的 安装 包 ， 可 以 使 用 下 列 链 接 选 择 下 载 社区 版 的 不 同安 装 包 ， 打 开 链 接 后 如 图 A-1 所 示 。 























http://neo4j .comr/download/other-releases/ 





Release Notes | Read More 
Linux/Mac Neo4j 3.0.1 (dmg) | Neo4j 3.0.1 (tar) Neo4j 3.0.1 
Windows 64 bit Neo4j 3.0.1 (exe) | Neo4j 3.0.1 (zip) Neo4j 3.0.1 (zip) 


Windows 32 bit Neo4j 3.0.1 (exe) | Neo4j 3.0.1 (zip) Neo4j 3.0.1 (zip) 


Neo4j 2.3.4 


19 May 2016 
Release Notes 


Linux/Mac Neo4j 2.3.4 (dmg) | Neo4j 2.3.4 (tar) Neo4j 2.3.4 


Windows 64 bit Neo4j 2.3.4 (exe) | Neo4j 2.3.4 (zip) Neo4j 2.3.4 (zip) 


Windows 32 bit Neo4j 2.3.4 (exe) | Neo4j 2.3.4 (zip) Neo4j 2.3.4 (zip) 


Neo4j 2.2.9 
31 March 2016 


Release Notes | Read More 
Linux/Mac Neo4j 2.2.9 (dmg) | Neo4j 2.2.9 (tar) Neo4j 2.2.9 
Windows 64 bit Neo4j 2.2.9 (exe) | Neo4j 2.2.9 (zip) Neo4j 2.2.9 (zip) 


Windows 32 bit Neo4j 2.2.9 (exe) | Neo4j 2.2.9 (zip) Neo4j 2.2.9 (zip) 











图 A-1 Neo4j 下 载 选择 























因为 本 书 实例 使 用 的 版 本 是 Neo4j2.3.2， 所 以 选择 Neo4j2.3.4 这 个 比较 接近 的 版 本 的 安装 包 下 载 。 对 于 系统 的 最 低 要 求 ， 参 照 官方 说 明 如 下 : 





* CPU: Intel Core i3 


“内存: 2GB 


“硬盘: 10GB SATA 














如 果 使 用 Linux 系 统 安装 ， 可 以 先 创建 一 个 目录 ,或 者 在 “/opt” 目 录 中 下 载 tar 安 装 包 ， 然 后 使 用 下 列 指令 解压 即 完成 安装 : 





#tar -xf 文件 名 











然后 切换 到 Neo4j 主 目录 ， 执 行 下 列 指令 启动 Neo4j 服 务 : 




















#./bin/neo4j start 




















如 果 在 Windows 上 安装 ， 使 用 Windows 的 安装 文件 ， 按 默认 选项 执行 安装 。 安 装 完成 后 ， 在 程序 菜单 中 打开 Neo4 Community Edition 窗 口 ， 如 图 A-2 所 示 。 























鳃 neoqj.. 


-Database Locatiom 


D: \neo4j\ebuy. db 














图 A-2 ”Neo4j 启 动 窗口 











数据 库 保存 位 置 使 用 默认 的 位 置 即 可 ， 单 击 Start 按 钮 ， 启 动 Neo4j 服 务 。 





如 果 不 是 在 本 地 调用 ， 需 要 开启 远程 调用 功能 ， 可 以 修改 neo4j-server.properties 配 置 文件 来 实现 ， 即 将 下 列 配置 项 的 注释 “#” 去 掉 即 可 。 





#org.neo4j .server.webserver.address=0.0.0.0 














还 有 一 个 配置 文件 neo4j.properties， 可 以 用 来 配置 使 用 内 存 的 大 小 和 日 志保 留 时 间 等 参数 ， 这 些 使 用 默认 的 配置 即 可 。 





























启动 Neo4j 服 务 之 后 ， 可 以 使 用 浏览 器 打开 数据 库 的 控制 台 ， 假 设 数据 库 安装 在 本 地 上 ， 使 用 URL 就 可 以 打开 控制 台 : 




















http://localhost:7474 








打开 后 需要 输入 默认 的 用 户 名 和 密码 : neo4j， 首 次 使 用 会 要 求 更 改 初始 密码 ， 如 图 A-3 所 示 。 





:SeEIVEIT connect 





Connect to Neo4j 


Database access requires an 
authenticated connection. 


Default username/password: neo4jyneo4j 














A-3 Neo4j 控 制 台 登录 界面 








登录 之 后 ， 在 控制 上 可 以 展开 左边 侧 边 栏 ， 如 单 击 Overview， 可 以 打开 操作 数据 库 的 面板 ， 查 看 节点 和 关系 ， 如 图 A-4 所 示 。 


S 介 从 Database Information 


Overview 
Node labels 
两 :Play start 


@ 





Relationship types 中 Neon Learmn about Neo4j 


A graph epiphany avaits you. 


232-COMMUNITY What is a graph 
Property keys 厂 database? 
How can | query a 


graph? 
What do people do with 
Neod ? 


232 © Start Learning 
D-\neo$\ebuy db 


318 71 KiB 











A-4 Neo4j 控 制 台 操 作 面 板 























Neo4j 控 制 台 是 一 个 用 HTML5 设 计 的 漂亮 的 操作 界面 。 现 在 就 可 以 开始 使 用 具有 服务 器 的 Neo4j 图 形 数据 库 了 。 























附录 B 安装 MongoDB 





MongoDB 提 供 有 Windows、Linux、OSX、Solaris 等 操作 系统 的 安装 包 ， 打 开 如 下 网 址 ， 可 以 看 到 如 图 B-1 所 示 的 下 载 选 项 。 














Jump into code 


Use Cypher, the graph query 


language 


Code walk-throughs 
RDBMS to Graph 


Query templates 


© Write code 








https://wuw.mongodb.com/download-center?jmp=nav#community 





Commmity Server Erterprise Server Ops Nanager 


Current Stable Release 
(3, 写 ) 是 丰 ndows 


08/16/2016: Release Notes | Changelog 
Dowmload Source: tzz | zip 


Yersion: 


Windows Server 2008 R2 64-bit and later, with SS5L support x64 


Windows Server 2008 R2 所 -bit and later, wmth 5L support x 
Server 2008 R2 64-bit and later, wthout SSL support x64 
Vista 32bit, without SL Support 1386 
Server 2008 64d-bit, without SL support x64 


山 DOWNLOAD (msi) 


Binary: Installatior Instructions | 局 1 Yersion Binaries 


图 B-1 下 载 MongoDB 安 装 包 








选择 使 用 Windows 的 安装 包 ， 可 以 选择 All Version Binaries 打 开 一 个 新 窗口 ， 选 择 适 合 操作 系统 版 本 和 位 数 的 安装 包 下 载 。 








例如 ， 在 D: 盘 中 安装 了 64 位 的 MongoDB 3.2， 找 到 类 似 如 下 的 pin 路径 ， 将 其 配置 在 Windows 的 环境 变量 path 中 。 


Compass 


Current Rele 


3 


as 


e | 








D:\Program Files\MongoDB\Server\3.2\bin 











创建 一 个 保存 数据 库 的 目录 ， 如 d: \mongodb\test， 然 后 打 : 个 命令 行 窗口 ， 输 入 如 下 命令 启动 MongoDB 服 务 : 











mongod --dbpath=d:\mongodb\test 





可 以 看 到 最 后 一 行 输出 如 下 信息 ， 表 明 服 务 启动 成 功 ， 并 且 开 放 了 访问 端口 为 27027。 








…waiting for connections on port 27017 





打开 另 一 个 命令 行 窗口 作为 客户 端 ， 输 入 命令 mongo 即 可 连接 上 服务 器 。 这 样 可 以 使 用 一 些 指令 做 一 些 简单 的 操作 测试 。 


显示 所 有 数据 库 : 





>show dbs 





切换 到 test 数 据 库 : 








>use test 





创建 一 个 名 称 为 person 的 集合 : 





> db.person.insert ({"name":"jack", "age":25}) 





将 集合 person 名 称 为 jack 的 记录 年 龄 改 为 30: 





> db.person.update ({"name":"jack"}, {"name":"jack", "age":30}) 





查询 集合 person: 





> db.person.find() 





显示 所 有 集合 : 





> show collections 





删除 集合 person 名 称 为 jack 的 记录 : 





> db.person.remove ({"name":"jack"}) 





显示 帮助 信息 : 





>help 








>exit 





以 下 安装 在 CentOS6.5 上 进行 。 


为 了 方便 在 本 机 上 进行 测试 ， 可 以 先 安装 tcl 支 持 环境 。 


附录 C 安装 Redis 





# yum install tcl 





使 用 下 列 指令 执行 下 载 、 解 压 、 安 装 : 





# wget http://download.redis.io/releases/redis-3.2.0.tar.gz 
# tar xzf redis-3.2.0.tar.gz 

# cd redis-3.2.0 

# make 

# make install 





安装 成 功 后， 拷贝 配置 文件 到 目录 /etc， 并 打开 文件 进行 编辑 。 





# cp redis.conf /etc 
# vi /etc/redis.conf 





编辑 配置 将 daemonize no 改 为 daemonize yes， 即 将 Redis 配 置 为 以 守护 进程 的 方式 启动 。 保 存 配置 后 ， 可 以 使 

















下 列 方式 启动 Redis: 








# /usr/local/bin/redis-server /etc/redis.conf 





但 是 为 了 更 加 方便 地 启动 ， 可 以 创建 一 个 启动 文件 ， 然 后 将 它 加 入 系统 服务 中 : 





# vi /etc/init.d/redis 





将 下 列 代码 复制 ， 粘 贴 在 上 面 的 编辑 中 (下列 代 码 保存 在 第 2 章 实例 工程 的 redis 模 块 的 doc 文 件 夹 中 ) 。 





#chkconfig: 2345 80 15 

#description: Start and Stop redis 
PATH=/usr/local/bin:/sbin:/usr/bin:/bin 
REDISPORT=6379 
EXEC=/usr/local/bin/redis-server 


REDIS CLI=/usr/local/bin/redis-cli 
PIDFILE=/var/run/redis.pid 

CONF=" /etc/redis.conf" 

case "$1" in 


start) 
if [ -f $PIDFILE ] 
then 
echo "$PIDFILE exists, process is already running or crashed" 
else 
echo "Starting Redis serverhttp://www.hzcourse.com/resource/readBook?path=/openresources/teach ebook/uncompressed/15925/0EBPS/Text/..." 
$EXEC $CONF 
£1i 
if [ "wsS2n="0" ] 
then 
echo "Redis is runninghttp://www.hzcourse.com/resource/readBook?path=/openresources/teach ebook/uncompressed/15925/0EBPS/Text/..." 
四 
stop) 
if [ ! ~-£f $PIDFILE ] 
then 
echo "“$PIDFILE does not exist, process is not running" 
else 
PID=$ (cat $PIDFILE) 
echo "Stopping http://www.hzcourse.com/resource/readBook?path=/openresources/teach ebook/uncompressed/15925/0EBPS/Text/..." 
$REDIS CLI -p $REDISPORT SHUTDOWN 
while [ -x ${PIDFILE} ] 
do 
echo "Waiting for Redis to shutdown http://www.hzcourse.com/resource/readBook?path=/openresources/teach ebook/uncompressed/15925/0EBPS/Text/..." 
sleep 1 
done 
echo "Redis stopped" 
LL 
restart |force-reload, 
${0} stop 
${0} start 


Ts 
echo "Usage: /etc/init.d/redis {startl|stopl|restart|force-reload}" >&2 
exit 1 
esac 











上 面 文件 保存 后 ， 更 改 其 执行 权限 ， 将 其 加 入 系统 服务 中 ， 同 时 设置 为 自动 启动 。 





# chmod +x /etc/init.d/redis 
# chkconfig --add redis 
# chkconfig redis on 





使 用 下 列 指令 查看 一 下 ， 如 果 2、3、4、5 项 为 开启 状态 ， 即 表示 配置 成 功 。 





# chkconfig --1List redis 





现在 可 以 使 用 下 列 指令 启动 Redis 服 务 。 





# service redis start 





启动 后 可 使 用 下 列 指令 在 本 地 测试 : 





# redis-cli 
127.0.0.1:6379> set foo bar 
OK 

127.0.0.1:6379> get foo 
"par™ 

127.0.0.1:6379> 
127.0.0.1:6379> quit 











上 面 测试 表示 Redis 已 经 正常 运行 ， 并 开启 了 默认 端口 为 6379。 如 果 系 统 开 启 了 防火 墙 ， 可 以 使 用 下 列 指令 开放 6379 端 口 : 

















# vi /etc/sysconfig/iptables 





插入 一 条 配置 : 





-A INPUT -m state --state NEW -m tcp -p tcp --dport 6379 -]j ACCEPT 








保存 后 重启 防火 墙 : 





# service iptables restart 





更 多 信息 可 以 参考 Redis 的 官方 网 站 : http://redis.io/download 


附录 D 安装 RabbitMQ 


下 列 安装 步骤 在 CentOS6.5 上 进行 。 
1. 安 装 erlang 语 言 环境 


安装 依赖 文件 : 





# yum install ncurses-devel 





下 载 erlnag: 





# wget http://www.erlang.org/download/otp src R16B03.tar.gz 








解压 : 





# tar zxvf otp_ src R16B03.tar.gz 





安装 : 





# cd otp_src R16B03 
# ./configure 

# make 

# make install 





测试 执行 erl: 





# erl 





即将 打印 出 类 似 如 下 的 信息 : 





Erlang R16B03 (erts-5.10.4) [source] [64-bit] [async-threads:10] [hipe] [kernel-poll:false] 
Eshell V5.10.4 (abort with ^G) 





退出 erl: 





Tr halt(}s 





2. 安 装 Python 
如 果 使 用 免 编译 安装 包 来 安装 ， 则 忽略 此 步骤 ， 直 接 进 入 第 4 步 。 


查看 原来 系统 自 带 的 Python 版 本 : 





# Python -V 





如 果 版 本 比 2.7 还 低 ， 则 下 载 2.7 的 版 本 ， 否 则 跳 过 此 步骤 ， 直 接 进 入 第 3 步 。 





# wget http://www.python.org/ftp/python/2.7.6/Python-2.7.6.tgz 





解压 : 





# tar zxvf Python-2.7.6.tgz 





安装 : 





# cd Python-2.7.6 
# ./configure 
# make && make install 





废弃 原来 的 Python， 替 换 为 2.7。 





# mv /usr/bin/python /usr/bin/python2.4.3 
# ln -s /usr/local/bin/python2.7 /usr/bin/python 





现在 再 查看 版 本 : 





# Python -V 





3. 安 装 RabbitMQ 


安装 依赖 文件 : 





# yum install xmlto 





下 载 : 





# wget http://www.rabbitmq.com/releases/rabbitmq-server/v3.5.4/rabbitmq-server 
“35.4.tar.ge 





解压 : 





# tar xvzf rabbitmq-server-3.5.4.tar.gz 





安装 : 





# cd rabbitmq-server-3.5.4 
# make 
# make install TARGET DIR=/usr/rabbitmq SBIN DIR=/usr/rabbitmq/sbin MAN DIR=/usr/rabbitmq/man DOC_INSTALL DIR=/usr/rabbitmq/doc 





配置 环境 变量 : 





# vi /etc/profile 








增加 一 行 : 





export PATH=$PATH:/usr/rabbitmq/sbin 





保存 后 ， 使 用 下 列 指令 让 配置 立即 生效 : 





# source /etc/profile 





启用 management plugin: 





# mkdir /etc/rabbitmq 
# rabbitmq-plugins enable rabbitmq management 





启动 RabbitMQ 服 务 : 





# rabbitmq-server - detached 





如 果 要 停止 RabbitMQ 服 务 ， 则 可 以 使 用 如 下 指令 : 





# rabbitmqctl stop 





4. 使 用 免 编译 安装 包 安 装 





如 果 已 经 使 用 第 3 步 的 方法 安装 成 功 ， 则 忽略 此 步骤 。 


下 载 免 编译 安装 包 : 





# wget http://www.rabbitmq.com/releases/rabbitmq-server/v3.5.4/rabbitmq-server-generic-unix-3.5.4.tar.gz 





解压 : 





# tar zxvf rabbitmq-server-generic-unix-3.5.4.tar.gz -C /opt 





建立 软 链接 : 





# cd /opt 
# ln -s rabbitmq server-3.5.4 rabbitmq 





配置 环境 变量 : 





# vi /etc/profile 





增加 一 行 : 





export PATH=$PATH:/opt/rabbitmq/sbin 





保存 后 使 用 下 列 指令 让 配置 立即 生效 : 





# source /etc/profile 





启用 management plugin: 





# rabbitmq-plugins enable rabbitmq management 





启动 RabbitMQ 服 务 : 





# rabbitmq-server - detached 





5. 管 理 RabbitMQ 


增加 一 个 管理 员 用 户 admin， 密 码 为 123456。 





# rabbitmqctl add user admin 123456 





将 admin 加 入 管理 组 。 





# rabbitmqctl] set user tags admin administrator 





假如 你 的 Linux 服 务 器 的 IP 地 址 是 192.168.1.214， 在 浏览 器 中 输入 下 列 网 址 打开 控制 台 : 





http://192.168.1.214:15672/ 





使 用 admin 登 录 ， 在 Admin 区 域 中 ， 创 建 一 个 在 程序 中 可 以 使 用 RabbitMQ 服 务 的 用 户 ， 如 alan， 如 图 D-1 所 示 。 








创建 完成 后 如 图 D-2 所 示 ， 这 时 用 户 alan 还 没有 使 用 消息 通道 的 权限 ， 显 示 为 No access。 


Channels Exchanges Queues 


vv Allusers 








Filter: | 国 Regex (?) 








admin 








vv Adda user 








Username: 


ET | rm |] 


* (confirm) 














Tags: (?) 
Set Admin | Monitoring | Policymaker | Management | None 














TIP API | Command Line 








图 D-1 RabbitMQ 管 理 界 面 








Connections Channels Exchanges Queues 














+ (confirm) 











|@) 





set Admin | Monitonng | policymaker | Management | None 


TTP API | Command Line 


单 击 用 





图 D-2 新 增加 的 用 户 alan 


户 alan， 在 出 现 的 编辑 界面 上 使 用 默认 选项 单 击 Set Permission， 赋 予 它 读 写 消息 的 权限 ， 如 图 D-3 所 示 。 





Admin 





This user does not have permission to access any virtual hosts. 
Use "Set Permission™ below to grant permission to access virtual hosts. 





Tags 
Can log in with password | 。 
v Permissions 
urrent permissions 
.. NO permissions ... 


et permission 





Configure regexp: Ca 





Write regexp: 





r 





Read regexp: 





”Update this user 





vv Delete this user 








图 D-3 编辑 用 户 权限 








现在 即 可 看 到 用 户 alan 已 经 有 了 使 用 消息 服务 的 权限 ， 如 图 D-4 所 示 。 这 时 可 以 在 程序 中 使 用 这 个 用 户 来 连接 RabbitMQ 服 务 器 了 。 














Tags 
Can log in with password | 。 


vv Permissions 


urrent permissions 





Virtual host | Configure regexp | Write regexp | Read regexp 


permission 


Virtual Host: 








Configure regexp: 


Write regexp: 








Read regexp: 


> Update this user 





v Delete this user 











D-4 赋予 用 户 alan 使 用 消息 服务 的 权限 








结束 语 




















本 书 以 一 些 非 常 切 近 生产 实际 的 应 用 实例 ， 介 绍 了 使 用 Spring Boot 进 行 一 些 基础 应 用 和 分 布 式 应 用 方面 的 开发 ， 同 时 分 析 了 Spring Boot 一 些 核心 功能 的 源 代码 和 实现 原理 。 通 过 这 些 应 用 实例 的 演练 
和 分 析 一 些 核心 功能 的 实现 原理 ， 让 我 们 不 但 掌握 了 如 何 使 用 Spring Boot 框 架 进行 不 同 层面 的 开发 技巧 ， 而 且 认识 到 使 用 Spring Boot 能 带 来 前 所 未 有 的 收益 。 







































































书 中 的 实例 已 经 涵盖 了 非常 广阔 的 领域 ， 从 各 个 层面 的 基础 应 用 到 分 布 式 管理 系统 ， 以 及 如 何 使 用 云 应 用 开发 工具 开发 各 种 高 可 用 的 微服 务 等， 并 且 都 进行 了 一 定 的 深度 挖 所 和 探讨 。 但 是 无 论 如 何 ， 
通过 本 书 的 实践 ， 只 能 帮助 你 使 用 Spring Boot 框 架 进行 开发 ， 让 你 在 使 用 Spring Boot 的 过 程 中 更 好 地 发 挥 你 的 长 处 ， 却 并 不 能 提供 更 多 关于 Spring Boot 的 各 个 方面 的 参考 ， 而 且 Spring Boot 时 刻 都 在 发 
展 之 中 ， 有 关 这 些 方面 的 内 容 读者 不 妨 关注 Spring Boot 的 官方 网 站 http://docs.spring.io/spring-boot/docs/current/reference/html/， 以 获得 更 多 的 知识 和 帮助 。 
































非常 高 兴 你 花费 一 些 宝贵 的 时 间 来 读 完 本 书 ， 真 切 希 望 本 书 能 对 你 有 所 帮助 。 如 果 你 能 因此 而 喜欢 或 者 爱 上 Spring Boot 这 个 开发 框架 ， 还 希望 你 在 使 用 Spring Boot 开 发 框架 的 过 程 中 ， 有 更 多 的 发 现 
和 收获 。 


